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PREFACE 



The Apple II Reference Manual contains a complete assembly listing of 
the Monitor program in the Apple II. The Apple II Monitors Peeled 
Manual (this hook) contains descriptions of the various routines in 

f. ho Monitor and address tables arranged by topic instead of in the 
.sequence of location within the machine- The material you find here 
lirtu been chosen and organized to allow programmers of the Apple II to 

make convenient use of routines it the Monitor from their programs. 

Many of the HAIXable points in the Monitor fall under more than one 

topic. The layout of this book is intended to minimize the 
necessity of page flipping and cross referencing , so those points 
which seem to bo appropriately described 
will be found in each applicable table. 



more 



■ 



This document covers the Apple II Monitor (both the Old Monitor and 
the Autostart Monitor versions), ROM address range $F800-$FFFF. This 
publication does not cover BASIC, APPLESOFT, DOS, HIRES , SWEET16, or 




There are two Monitor ROM's available for the 
Monitors are identical for most functions, 
features. This book describes both Monitors, 




e II. The two 
differ only in certain 
indications provided 



Jitvnc thousands of Apple II computers have been shipped with the 
r.irlier version of the tlonitor. In this book, that will be referred 
to the Old Monitor. In 1979, a new version of the Apple II Monitor 

wan developed. This Monitor contains new features to facilitate system 
Htart-up and program editing, at the expense of removing the 
Instruction trace and single step facilities and sixteen bit multiply- 

clfvlde routine of the Old Monitor. This new Monitor is called the 
Autostart Monitor in this book. The Autostart Monitor is available 
iron Apple Computer Inc. and from nany computer dealers under the 
name Autostart ROM, Apple Port No. A2M0027. 

ft is easy to determine which Monitor is in a nachine. If the machine 
comes up with the APPLE II legend at the top of the screen whan the 
power ia turned on, the machine contains the Autostart Monitor. If the 



contains the Autostart 
machine comes up with the Monitor prompt <*) then it cont 
Monitor. 



A program can also 
Autostart ROM. The byte at $FAF 
Autostart and $01 in the Old Monitor. 



determine whether the Monitor is the Old or the 



OVERVIEW 



CHAPTER 1 

MONITOR USAGE MEMORY MAP 

Use of menory by the Monitor and by the Apple II for machlnr 
control and display to the screen. 



PAGE I 



Description in detail of all memory locations in page zero um'd 

by the Monitor, indicating legal range of values and all roiitinrn 
which use the location. 




PAGES OWE THROUGH THREE 
al descriptio 
'iptlon of 

PAGFS FOUR THROUGH. SEVEN AND ELEVEN 

Description of how text is maintained in "screen refresh memory" 

for display on the screen, both primary and secondary display 
areas for text and Low Resolution (Color) graphics. 

PERIPHERAL CONTROLLER WORK AREAS 

A chart showing the scratchpad areas 

use by peripheral controller programs. 



CHAPTER 2 



KEYBOARD INPUT DIVISION OF LABOR 

Descriptions of the lower level routines used by the Monitor to 
read data from the keyboard, including subroutines for cursor 



USER CALLS TO KEYBOARD INPUT ROUTINES 

Specifications for user calling of the routines at all levels for 

input of characters from the keyboard and for user program 

simulating (replacing) the keyboard as the ir 



KEYBOARD INPUT MONITOR ROUTINE 

Table 1 contains addresses for character by character input from 
the keyboard via the routines described in the previous section. 
Table 2 contains addresses for line input from the keyboard. 



OVERVIEW - TEXT OUTPUT TO THE SCREEN 





WITHIN THE SCROLL WINDOW 

description of the normal method of printing data to the 
as used by PRINT of BASIC, Including page zero reference 



5. 



SCREEN FORMAT CONTROL BY ROUTINE 

Table of addresses of routines in the Monitor which control the 
fomat of the Scroll Window and the format of data display. 

SCREEN FORMAT CONTROL BY POKE / STORE 

of methods of controlling the s 

I « ^ j ■ . .i 





Description of facilities for a 
current position or to an 




L TEXT TO THE SCREEN 
Printing data to the screen whether some other device has been 
established (via CSWL) or not, and printing some things by a call 
to a Monitor routine which loads the A-reg and calls COUT itself. 

TEXT OUTPUT WITHOUT THE SCROLL WINDOW 

Ways and means of handling the screen as a formatted c 

device, with or without part of the screen being 
Scroll Window. 




SECONDARY DISPLAY AJ5EAS 

' «. .. - « v - . 





OF INTERRUPT 

General and specific de 

processing with regard 
In particular. 



tion of interrupts and interrupt 
to computers in general and the Apple 



II 
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RESET INTERRUPT - OLD MONITOR 

Description of handling a RESET interrupt with address 
allowing user call to subsets. 



INTERRUPT - AUTOSTART MONITOR 
Description of handling a RESET interrupt with address table 

use. 




IRQ/BRK INTERRUPT HANDLING 

Descriptions of handling these types *>J 

Monitors, with Address Tables. 



MACHINE LANGUAGE DEVELOPMENT AIDS 

Address table for routines in the Monitor which can be callrd \v 

provide debugging information either by moving the Information r., 

•*"" - 1 — 1 through mm\ 



Descriptions of the routines in the Monitor which support thin 
function, with a table of addresses for directly calling them. 



MANIPULATION FUNCTIONS 

Description of the routines in the Monitor 
one place to another, or change the 
item with regard to anott 



I move data from 
►erate on one 



MONITOR COMMAND PROCESSOR 

■ ■ 

How to call the Monitor Command Processor, to have it execute 
Monitor commands and return Co caller or stay in Monitor mode. 

SPEAKER (BELL) USE THROUGH THE MONITOR 

No music here. This is a description of how to use the speaker an 
a signaling device in the same manner as the error alarm or RES 
key alarm. 



TAPE INPUT AND d 

Description of all the routines involved with reading or writing 
of tape, with user call information specified for the high level 

routines. Includes list of calling programs for each point. 

PADDLES, BUTTONS, AND ANNUNCIATOR I/O 

Description of paddle reading for the machine language programmer 
and addresses to use for all these devices. 

WAIT ROUTINE 

This routine will take control of the machine for a length of 

time depending upon the input A— reg value. Table and formu! 

provided for use where interval between events is critical. 

OF CONTROL-Y WITH PARAMETERS 
Les. 




REGISTERS FOR BASIC MONITOR CALLS 

The Monitor GO command routine makes it possible to call from 
BASIC most Monitor routines which receive input in registers. 

DECIMAL TO HEX CONVERSION 

A sample program that shows how to convert from decimal to 
hexadecimal • 



STEP AND TRACE PECULIARITIES 




hine with and without 




MEMORY ALLOCATION 



MONITOR USAGE MEMORY MAP 

Memory is divided into 256 byte sections, generally referred to as 

address of a byte in page zero inay be expressed in a single byte. 
Many 6502 processor instructions are only two bytes in length 
the operand is in page zero. Thus, Monitor usage of page zero 
receives heavy treatment in the following section. 

Page one (address range $0100-$01FF) is also special in the Apple IX. 
This entire 256 byte area is called the "stack". The stack is a 
temporary storage area for which special instructions are provided in 
the 6^02. The contents of the A-register or P-register may be pushed 
onto the stack, which means the contents of the indicated regist. 
are stored in the stack at the location currently specified by the 
S-register: then the S-register is decremented. Data may be pulled or 
popped from the stack, which means that the S-register is 
Incremented, and then the byte pointed at by the S-register is picked 
up into the appropriate register. A JSR instruction causes the 
current contents of the Program Counter to be pushed onto the stack 
before the jump. An RTS instruction pulls two bytes from the stack 
into the Program Counter. 

The Monitor contains instructions which use the stack. However, the 
Monitor does not initialize the stack pointer register to a preset 

value or load the S-reg at any time- 



Page two (address range 
keyboard input area. The 

calling program after the next ci 




is defined in 
tines wh 
into page 



the Apple II as the 

support reading of 
two for us* by the 



Page three is address range $0300-$03FF. Host of this area is unused 
by the Monitor. Quite often the first 200 or so bytes are used for 
machine language programs called by APPLESOFT or BASIC programs. The 
Monitor uses only the last 16 bytes, as described in the Page Three 
Address Table. (Note, however, that DOS uses the 32 bytes before the 
Monitor's 16.) 



Pages four through seven comprise the primary text or color graphics 
display area. Pages eight thru eleven comprise the secondary text or 
color graphics display area when that feature of the Apple II is 
used. However, page eight is generally the first page of the user 
urea. In the address table, pages four thru seven and eit' 

eleven are dc— ^ Ji »-«r„, LtiLt 

screen line. 




From address $0800 to the end of memory in the machine is the user 
area for programs and data. However, if High Resolution Graphics is 
in use, then memory area from $2000 through $3FFF is the primary 



display area for that function and $4000 through $ 
the secondary display area fur that function. 





0000 |Page zero 
00FF | 


— — ——— ———— — — — — ———— — ———— — — — ———— — — — ——— 

0100 [Stack 
01FF | 


0200 lKeyboard Input 
027F ] 




0300 |Available 
03CF | 

03 D0 |DOS 

03EF | 

03F0 [Vectors 
03FF | 


0400 [Primary Text 
07FF [and LORES Area 


0800 [User Program 

[and Data space 
0BFF [to RAM size. 

1 

|ROM APPLESOFT 

[USER PROCRAM 
2000 | 

f INTEGER 
2FFF | BASIC DATA 

1 

3FFF | 
1 

A000 [ 
1 

5FFF , 




RAM APPLESOFT 
COMPILER/ 
INTERPRETER 


and LORES 






RAM APPLESOFT 
USER PROGRAM 


Secondary HIRES 




7FFF -end 32K machine 

! 

Wm -end ASK machine 







PAGE ZERO 



The Monitor makes use of the p<igc zero locations from 32 ($20) through 
73 ($49) for general functions and normal operations. Locations 74-77 
($4A-4D) are not touched by the Monitor. Locations 
modified as described below to 

■ ■ 

for an application program. 





The Autostart Monitor uses locations and 1 during system 
initialization. This initialization is described in the section on 
"RESET Interrupt - Autostart Monitor" and below in describing the use 
of locations and 1. 




Addr Addr Label Description 



00 



S00 
$01 



LOC0 
LOCI 



31 $.1 



These locations are used by the Autostart Monitor 

during the automatic Disk Bootstrap function which 
takes place when the computer is powered up. Using 
these locations for indirect addressing, the slot 
addresses are checked - from slot 7 down thru 
slot 1 - to determine presence of a disk coi 
If one ts found, a Jump Indirect via $00-01 is 
d to ii 



- 



Left column of the Scroll Window: 
Range is to 39 ($27). 

This field is used only in VTABZ which sets 
to the memory location corresponding to CV and 
WNDLFT. The contents, when changed ty user 
program, become effective on the next scroll 
operation, clear to end of page operation, or 





After changing the contents 
VTA3 or print a carriage 
make it take effect. 



is 1 to 40-(WNDLFT). 

character is written through COUT to the 
screen it is placed at (BASL).(CH), after which CH 
is incremented. Then (CH) is compared with 
(WNDWDTH) to determine whether the cursor has 
exceeded the right margin of the Scroll Window. 
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Dec Hex Monitor 

Addr Addr L abel Description 



34 $22 WNDTOP 



Top line of the Scroll Window: 

Range is 9 to 22 (S16) for full text screen. 

and text. 

Valid values for VTAB in Basics are 21, 22, 23. 

:ield Is used during a scroll operation to 
indicate the line on which the operation should 
start. It is also the line on which the cursor is 
placed on completion of a HOME operation (clear 
the window, place cursor at top left). 

Nominally, bottom lire of Scroll Window: 
Range is (WNDTOP )+l to 24 ($18). 

WNDKTM contains the number of the first line below 
the Scroll Window. Contents of VNDBTM are tested 
only on output of a carriage return (Son) or line 
feed ($8A). It la used by Clear to End of PaRe and 
by Scroll routines. 

from WNDLFT where next character to 
be placed; Ran^e is to 
O - I. After the screen output routine 
places a character into the screen area as 
part of normal character output, CH is then 

incremented and compared to WNDWDTH- If CH is not 
less than WNDWDTH , a carriage return will be 
simulated • 





37 $2 5 



CV 



Mote that CH is used for echoing keyboard input to 
the screen by the Monitor GETLN etc. routines. 

Vertical screen position (lino number) for next 

character to he written to the screen: Range is 
to 23 ($17). The content of CV is relative to the 

top of the screen, not to the ton of the Scroll 
Window. It nay fee set by loading the desired line 
number into A-reg and calling TABV. It nay be set 
hy POKKing the line number into CV and then 
calling VTAB. Actual storage of a character into 

the screen area includes use of BASL,H for line 
number, not CV. The calls above to VTAB or TABV 

are to sei BASL.Tl from CV (and WNDLFT) for 
immediate future? reference. 



If CV is at below WNDBTM it will remain on tho 
current screen line as carriage returns go bv 
while the contents of the Scroll Window will be 



f>ec Hex Monitor 

Addr Addr Label Description 
■ — — zx. z. 



Memory address within the screen area of the left 
end point of the desired line for LORES plot. This 
field is set by the GBASCALC routine to the memory 

ym%sg®mmiw* m,mber mm 

This two byte field is the memory address for the 
left end character position of the current text line, 
line, within the Scroll Window. The contents are a 
function of CV and WNDLFT. 

This field is set by the BASCALC routine to point 
to the raemory address for the left end of the 
screen line specified in the A-reg. This call to 
BASCALC is usually accomplished by the VTAB 
routine, which then adds (WNDLFT) to BASL , H to 

point to the left end of the line within the 
Scroll Window. 

This two byte field is used as a work area only 
during a scroll operation* It is the destination 
line pointer usod as each line is moved to the 
position above current. 

U $ 2C 112 Right end point of horizontal line being drawn by 

the HLINE routine: Range is to 39 ($27). 

This byte is set by the calling program before 
HLINE is called. 

LriNKTi Low byte of two byte pointer (LMNEM, RMNEM) used 
by Disassembler as index to mnemonics table. 

RTNL Save area used by the Instruction Trace routine 
of the Old Monitor. 

Bottom point of a vertical line being dravn by 
VLXNE routine: Range is to 39 ($27) for mixed 
screen, to 47 ($2F) for full screen graphics. 
This byte must be set before VLINE is called. Note 
that this byte is used when the Clear Screen 
(CLRSCR) routine uses VLINE to clear the screen. 

RHNEM Used with UiNRM as table index for mnemonic table 
by the Disassembler. 

RTNH Used with RTNL as a save area by the Instruction 

Trace routine of the Old Monitor. 



n $26 GBASL 



W $28 BASL 
M $29 BASH 



m $2A BA52L 
43 $2B 3AS2H 
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Dec Hex Monitor 

Addr Addr Label Description 



46 S2E MASK 



ii 



it 



With this label, this location is used as a $0F 

horizontal plot lines represented by the GBASL ,H 

contains two points on the screen, one above the 
other. MASK is us 
while leaving the other unchanged. 

Using this label, the Disassembler uses this byte 
as temporary storage for the code which indi- 
the format of the instruction for display 
pur] 



■» 



ii 



47 $2F 



as 



This byte is used during cassette tape read to 
continually accumulate the checksum which will 
be compared to that generated during the write 
operation which created the record. This byte 
initialized to zero at the beginning of a tape 
read. As each byte is stored into memory it is 
Exclusively OKed against CHKSUM. After the last 
byte has been stored, one more byte is reail from 

the tape and compared to CHKSUM. If equal, a good 
read nay be assumed. As this result is not finally 

stored back into CHKSUM, that field cannot be used 

by the calling program to determine success or 

failure of the read. A method for this 

determination will be found in 

"CasseLte Tape Input and Output". 



* 





as a work area to determine whether the sense of 

input from the — — - — — 

changed • 



This field is set by the Disassembler to indicate 

the length of the instruction. After output of the 

disassembled instruction, ?CADJ uses this value to 
compute new values for PCL,H, which are returned 

to caller in the A and Y reg for user storage to 

. .. .1" the Old Won «~ 



* 




Instr, 
to the i 



ter a call to MULPM or DIVPH (signed 16 bit 

tiply or divide in the 3ld Monitor), the $01 
bit of this byte is set if the always-positive 
": is to be complemented by the calling 
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Dec Hex Monitor 

Addr Addr Label Description 



m $30 COLOR This byte contains the code for the color of 

points to be placed on the screen in graphics 

mode. The SKTCOL routine is entered with a value 

in the low order four bits of the A-reg. This 

value is then placed in both the high and low 

nibbles of COLOR. COLOR is then used with MASK in 

setting the value of the byte in the screen area 

to accomplish setting a particular point to the 
selected color. 



9 $31 



51 



Color can be set directly by stuffing the v 
multiplied by $11 in color. For example, 
= orange (9): From assembly - 



STA color. 




9*17. 



This byte is used by the Monitor command 
processing routines to control parsing and to 
control operations when a blank is encountered 
after the hex digits. For example, a hex address 
followed by a colon causes setting of MODE so that 
during further processing of the input line each 
blank encountered signifies end of a hex value to 
be placed in memory During parsing, the contents 
of MODE indicate where the hex values should be 



for use when the command : 

encountered. MODE is set to appropriate J 
plus, minus, colon, and period. 



This byte is a mask used by C0UT1 to cause 
characters written to the screen area to display 
white on black (INVFLG=$FF) or black on white 

(IKVFLG=$3F) or blinking (INVFLC=$7F) . This field 
is set to $FF when a RESET occurs by the routine 
at SETNORM. The routine called SKTINV can be 




set b 



This byte contains the prompt character which is 
written to the screen by the Monitor GETLN routine 
in preparation for reading a line of characters 
from the keyboard. When the RESET key is pressed, 
the Old Monitor quickly enters the HON routine, at 
which point the PROMPT field is set to $AA, "*". 
The Autostart Monitor also sets the prompt 
character at the MOJI routine, but this is nut 
'ly a part of processing the RE"™ 
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Dec Hex Monitor 
Addr Addr Label 



Description 



52 $34 YSAV 



This byte is a save area used by the Monitor 

Command Processor. The Y-reg is used by the 
Command Processor in indexing through the input 
line. When a command has been decoded, the Y-reg is 
saved at YSAV before* going to the selected 
routine. On return to the Command Processor, the 
Y-reg is reloaded from here before transfer 



line. 



This byte is a save area for the Y-reg across a 
call to the screen output routines. Y-reg is saved 
and restored in the C0UT1 routine. 



54 $36 CSWL 



This two byte field contains the address of the 

routine which is to receive and dispose of output 

characters. When the RESET key is pressed this 
field is initialized to point to COUT1 to send 

output characters to the screen* Entering a 

Monitor Command nPc (n=port number, Pc=control-P) 

will cause the Monitor to set CSWL to 00, CSWH to 

Cn. The routine at that location will then receive 

(in the A-reg) each byte "written" through COUT, 
which is a JMP (CSWL). 



If the Monitor Command "0Pc" is executed, CSWL, II 
is set to point to C0UT1 instead of to C000. 



56 $38 KSWL 

57 $39 KSWH 



This two byte field contains the address of the 
user input routine. It is set by RESET key 
processing to point to KEYIN which gets its input 
from the keyboard. The Monitor Commard nKc (n=port 
number, Kc=control-K) causes the setting of KSWL 
to 00, KSWH to Cn. This routine is then called any 
time the Monitor or executing program asks for 
another byte of input by calling RDKEY or one of 
the routines which in turn calls RDKEY. 



The Monitor Command "0Kc" results in setting 
KSWL,H to point to KEYIN instead of to C000. 



58 $3 A PCL 

59 $3B PCH 



This field is a save and control area for the 
Program Counter. In addition to the Mini Assembler 

be placed. 



st rue 



When a BRK instruction is executed, this field is 
set to indicate the address stacked by the 6502, 
Lnting to two bytes beyond the BRK instruction 



Dec Hex Monitor 

Addr Addr Label Description 



This field is used during Monitor commands L and G 

nd Monitor "GOTO"). During 
itructions this field is 
incremented as required. This field Is used for a 

*f t-rt Qvociif 1 <\r> r\f f-V> a Mr» nl n 



Jump Indirect in execution of the Monitor G 
command • 




Updating of this field Is accomplished with the 
assistance of the PCADJ routine whenever use 
requires Incrementing in accordance with the 

length of the instructions. (See LENGTH at 47 or 
$2F.) On return from PCADJ, store A to PCL and Y 

to PCH to accomplish update. 

This field is used by the Old Monitor in support 
of Monitor commands S and T (single instruction 
step and instruction trace). For those functions, 
it is maintained as a pointer to the next 

to be handled. 



f>0 $3C XQT 

XQTNZ 
M-6/ $3D-$43 



: . 



61 $3D A1H 



This field is used as a work area for instruction 
step and trace in the Old Monitor. The field is 

eight bytes long and overlays A1L,H; A2L,H; A3L,H; 
and AAL,H. The next instruction to be executed 
(indicated by the contents of PCL,H) is moved to 
this field, possibly modified depending on 



■ » 



Multipurpose Ifonitor work area: 

May be clobbered by Instruction Trace in 

the Old Monitor; see XQT above. 

When the Monitor begins processing a command, MODE 

is initialized to zero. As the input line is 
scanned, hex digits are first placed into A2L,H. 
From there they are moved also to AlL,H and A3L,H 
as long as MODE remains zero. When a plus, mini 
colon, or period is encountered, MODE is modif: 
to indicate which, and A1L,H will continue to 




AlL,H is the primary index for the 
command, memory examine or display. 



AlL,H contains the addend 

■ 



the Monitor 



Dec Hex Monitor 

Addr Addr Label Descripti o n 



A1L,H contains the minuend for the Monitor 
SUBTRACT command. 

A1L,H is the source field pointer during the 
Monitor HOVE command. 

A1L,H is one of the two indices used in the 
Monitor VERIFY command. 

A1L,H is the source field from which PCL,H is set 
on L and G Monitor commands, and the Old Monitor 
commands S and T, if an address is specified. If 
no address is used in the input line, then PCL,11 
is the residue of the last command which 
maintained or used it. 



A1L,H is the memory pointer used for cassette tape 
READ and WRITE Monitor operations. 

Monitor routine NXTAl increments A1L,H by one and 
then compares the result to A2L.H. If A2L,H is 
less than AIL, II, then Carry is set when control is 
returned to the calling program. 

62 $3E A2L Multipurpose Monitor work area: 

63 $3F A2H May be clobbered by Instruction Trace in 

the Old Monitor; see XQT above. 



This field Is the receiving field into which hex 
data is stored from the input area during Monitor 
Command parsing. When the command itself is 
encountered, A2L,H contains the last parameter 
entered. While MODE contains zero (until a plus, 
minus, colon, or period is encountered) A2L,H is 
continually copied into A1L,H and A3L,H. If a 
"less than" sign is encountered, A2L ,H is 
immediately copied to A4L,H and A5L,H. 



A2L,H is used to terminate 
display), tape write, tape 
memory verify operations. 



examine (memory 

read, memory move, and 



A2L.H contains the subtrahend in a Monitor 
SUBTRACT c 




.mand 



A2L.H is the source field and A3L 
as the pointer for the Monitor 




Dpc Hex Monitor 

Add r Addr Label Description 



\2L,H contains the port number in an input port 
select or output port select (control Kor P) 



A2L 
se 

command. 



Monitor routine NXTAl increments A1L,H by one and 
then compares the result to A2L,H. If A2L,H is 
less than A1L,H then Carry is set when control is 




Multipurpose Monitor wo 
May be clobbered by Ins 
Monitor; see XQT ab 

■ 




1L,H and A3L , H are both filled from A2L, H during 
onitor Command Drocessins scan of the incut line 



ri 




A3L,H is used as the desti 

■ 



Ion 



ir 



A3L,H is used as a work area by the Register 

Display routine, which is called by the control-E 

Monitor command, or as part of the single cycle or 
— of the Old Monitor, 



1 




fonitor; see XQT above 



his field (and A5L,H) are loaded 



in the Old 



A2L.H 




M is the 





lm field pointer during 



a 



M the second fie 
Y operation. 



Tonitor routine NXTA4 increments AAL,H by one, and 

then drops into NXTAl, which increments A1L,-H by 

one and then compares the result to A2L,H, If 

A2L,FI is less than .A1L»H then Carry is set when 
control is returned to the calling program. 
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Dec Hex Monitor 

Addr Addr Label Description 



68 $44 A5L 



Multipurpose Monitor work a) 

This field is not 
XOT, which, in the 

through A4JL 




the area of 



»5 = 



This field is filled from A2l ) ,H as described above 

for A4L,H. However, the field is not otherwise 

referenced within the Monitor, except that ACC 

(below) is also A5H. 



69 

70 
71 

72 



$45 

$47 
$48 



ACC 
XREG 
YREG 
STATUS 



This five byte field is a register save area. 
With the following exceptions, the 6502 registers 
are stored by the SAVE routine and reloa 
RESTORE routine. 



reloaded 



by ! 



le A-reg is stored at ACC by the IRQ routine on 
either an IRQ interrupt or execution of a BRK 
instruction- On a BRK, entry into the SAVK 
routine at label SAV1 is used to store the rest 
jf the registers. The other registers are not 




this area on 



er execution of a BRK instruction or on 




of Monitor command control-E, the 

ents of this area are used to display the 
tsters" on the screen* 



The registers (except S-reg) are loaded frora this 
area before jumping to the requested location on 
execution of the Monitor G command. 

In the Old Monitor Step and Trace command 
routines, the registers are stored here after each 

tSlfeSSTS aster before the nexc 



74 
75 
76 



$4A 
$4B 
$4C 



unused 
unused 
unused 



Dei: Hex Monitor 

Addr Addr Label Description 



78 $4E 
79 



RNDL 



Random number field, 16 bits: 

This field is continually counted up by the KEY IN 

key pressed. Thus, t' 



results are effectively randon as it doesn't take 



There is no other 
reference to this field within the Monitor. 



ft0 $50 

HI $51 

H2 $52 

83 $53 

H4 $54 

H<i $55 



ACL 

ACH 

XTNDL 

XTNDH 
AUXL 



These three two^byte fields are used only by the 

multiply and divide routines in the Old Monitor, 
Tnese routines are not called from any place in 

the Monitor. Therefore, these fields are used 
only if a user program makes use of the multiply 

or divide routines. 

The section on Data Manipulation Functions 
contains a full descri — ^ ™,i>^i~ 
divide routines* 



PAGES ONE THROUGH THREE 



PAGE ONE ($0100-01FF) 

I'afte one is the hardware stack area. Monitor use of this area is 

only by means of the 6502 instructions which use the stack, such as 

I'llA, JSH, RTS, etc. The Monitor does not initialize or set the stack 

pointer (S-register) on a RESET or Power On interrupt or at any other 
t I me. 



PAGE TWO ($020Q-02FF) 



I'/iK*' two is the Keyboard Input buffer area. At label "CETLN" the 
X-ri-nlster is initialized as an index. At label ADDINP the character 
ri'jid from the keyboard is stored into page two indexed by the 
X-r«7.1ster. The result is that on return to the calling program the 
rim meters read from the keyboard have I 
Stfl'.W and up, the last character stored 




PAGE THREE ($O3OO-03FF) 

Pn.fi£ three contains ''vectors'' for special handling of certain 
Interrupts at the high end of the page. The low end of the page, 
thrtJuftli S03CF, is often used for machine language subroutines. 

Kr.m, WW through $03EF is used by DOS. 




Function 



$0300-$03EF 768-1007 Not used by the Monitor. 

$03F0-$03Fl 1003-1009 The Autostart Monitor uses this location as the 

BRK instruction interrupt vector (address). 



$03F2-$03F3 1010-1011 



This is the RESET (Soft Entry) Vector (address) 

used by the Autostart Monitor, as described in 

the section " r 
Monitor". 




Powered Up indicator: if the Exclusive OR of 
"SA5" with the content* of $03F3 fa equal to 

the contents of $03F4 then the RESET (Soft 

Entry) Vector is considered valid. Otherwise, a 
RESET interrupt will cause the Autostart 

Monitor to go through power-up initial: 

including boot of DOS if available. 




on, 




$03F8-$03FA 1015-1018 Control-Y Vector 
$03FB-$03FD 1019-1021 Non-Maskable Interrupt Vector (instruction). 



$03FE-$03FF 1022-1023 IRQ Interrupt Vector (address). 



PAGES FOUR THROUGH SEVEN & ELEVEN 




Address $0800 is generally the beginning of memory available to the 

user for general program or data storage. However, $0800 through S0BFF 
i g the secondary text and low resolution graphics display area. By 

POKEing -16299 with any value, the screen display hardware can be 
directed to display to the screen from this secondary display area 
instead of the primary display area. POKE -16300,0 to switch "sack to 
the primary display area. 



Although the hardware will display to the screen from the i 
display area, the Monitor does not support the feature. T\ 

,C routines in the Monitor convert the 11 
input to the routine to the appropriate memory address for 
display area only. Use of the secondary 1 
the section "Secondary Display Areas". 




Contiguous screen lines are not in contiguous nemory locations. The 
characters on a screen line are in the same sequence in memory as on 
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the screen, but the lines are mixed in a manner which simplifies the 

hardware display to the screen. The following table indicates for each 

line the address in memory for the leftmost character of the line in 
both the primar 



The IiASCALC routine in the Monitor computes the memory address for the 
line number input to that routine in the A-reg. Using the - — 




IULM-1. , (-11. 



Input line m 



This can be arit 

place of the ANDs 
"L" (0- 23), 





SCREEN MEMORY ADDRESS TABLE 





1 

2 

3 

4 

5 

6 

7 



t r 

12 



is 

16 

"7 
18 

.9 



Primary Display Area 
Decimal Hex 

0400 

0480 
0500 
0580 
0600 
0680 
0700 




0528 
05A8 
0628 
06A8 
0728 
07 AO 
0450 
04D0 
0550 



23 




Secondary Displ ay 
Decimal Hex 

0800 

08S0 
0900 
0980 
0A00 
0A80 
0B00 



0828 
08A8 
0928 
09A8 
0A28 
0AA8 
0B28 
0BA8 
0850 
08D0 
0950 
09D0 
0A50 



07D0 




It Is also Interesting to note that although 24 lines of 40 characters 
compul.'B to 960 bytes, the memory area described above contains 1024 



pages four through seven are not displayed on the screen- 
are eight groups of eight bytes each. This space has been 

: for use by peripheral controller cards 1* slots one 
-he follow! no table shnw? th P allocation. 



These bytes 




■ 



or 



;omplished, with potentially 



these locations can be c 



if an image of the s 

elsewhere and moved to this area in a block, the locations identified 

below will be modified. If a program is loaded from tape with the 

Monitor command mmmm.n?mnR, and if mnmn is less than $0400, then the 

bytes in the following table will be loaded from the tape* If an 

attempt is made to save the screen area to disk and later BLOAD it to 
the screen area, results can be confusing. The Disk Controller card, 

and possibly some peripheral device interface cards keep control 

information in these areas. For example, doing the above mentioned 
BLOAD fron> drive 2 when the BSAVE had been done from drive 1 will 
result in the disk switching back to drive 1. 



The Reference Manual indicates that one must be sure that Scroll 




than i 

unfortunate result if this caution is not observed. 



PERIPHERAL CONTROLLER WORK AREAS 



Common 




Slot 
1 



Slot 

2 



Slot 



Slot 
4 



Slot Slot 



Slot 
1 



1144 
1272 

1528 
1656 



0478 

04F8 

0578 
05F8 
0678 



0479 
04F9 
0579 
05F9 
0679 



04 7A 
04FA 
057A 

mm 

067A 



1784 06F8 06F9 06FA 



077A 
07FA 



047B 
04FB 
057B 




047C 
0AFC 
057C 
05FC 

067C 

067C 
077C 



047D 

04 FD 

057D 
05FD 

067D 
06FD 



04 7E 
04FK 
057E 
05FE 
067F 

06FE 



7FI) 



07FE 



04 7F 
04FF 
057F 
05FF 
067F 

07FF 



* Location 2040 (S07F8) has special significance. This location 
be loaded with $CN, where N is the slot number of the active 
peripheral, whenever an interrupt nay occur and the ROM/PROM expansion 
scheme Is in use. This is necessary so that the return from interrupt 
software used allows the proper peripheral card to resume operation. 



The default operation of the screen is as a scrolling device: new data 
is entered or output at the bottom of the screen and all above is 
shifted up line by line until the oldest information disappears off 
the top of the screen. With a little extra work in the user program, 

it is also possible to use the screen as a formatted display. 
Following is a description of the effects of that type of use, and 
some suggested solutions to the situations encountered. 



Characters generated by the ucer program for display on the screen are 
handed to the Monitor one character at a time. The screen output 
handlers check for control character vs. display character, and operate 
in accordance with what they find. For example, output of a carriage 
return character or line feed character while the cursor is on the 
bottom line of the screen will cause a scroll operation to take place. 
If the screen is being used with a format instead of as a scroll 
device, then the program can easily avoid output of a carriage return 
or line feed when the cursor is on the bottom line of the screen. 



The easiest way for the user program to read information from the 

keyboard is to call the Monitor at the point where it will read in a 
line (up to a carriage return) before returning control to the calling 



at the same place in memory. There is, however, a conflict between 
using this type of a call and using the screen as a format type 

display. While the Monitor is receiving the keyboard input, ** 

. at the current c 





carriage return, tV 
the cursor current line from cursor to the right end of the lit 
(within the Scroll Window). Thus, the user progr3 
before asking for Input from the keyboard the cursor i 
there is no significant data to the right. 




It is possible to divide the screen into scroll area and non-scroll 
area. Many complications arise from this method of operation, so the 
recommended solution to the format 



screen full scroll and 
desirable. 



services when they are not 



The entry points and qualifiers for using scroll and non-scroll areas 
will be found in the section on Text Output Without the Scroll Window. 

KEYBOARD INPUT DIVISION OF LABOR 



The 

the keyboard input to the screen (through COUT) at the current 

position, and store the entered characters in the keyboard input ;vre;-i 
( $0200-$02FF) for the convenience of the calling program. 

executing program may position the cursor anywhere (in the Scroll 

Window) before calling the Monitor keyboard Input routines. On entry 
of a carriage return from the keyboard, the Monitor keyboard input 
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routines will cause return of control back to the calling program with 
the character count plus one in the X-register and a carriage return 
in the input area as a terminator- The program need not look into the 
screen refresh memory to determine what was entered. (Note: The X- 
Register begins with a zero, so that if five characters are entered, 



le routines described below are included in the address table. The 
■ollowing section, "User Program Calls .«•", describes program setup* 

for calling some of these entry points. Hex address, + Decimal 

address, and - Decimal address are given in brackets beneath each 
routine. 



TABLE OF 




Routine Description 



GETLNZ 
[SFD67] 
[64871 J 
[- 665] 



Entry at this point causes output of a carriage return 
character and read the data. 



GETLN 

t$FJ)6A] 

[64874] 

[- 662] 



Entry at this point is with the cursor oroperly positioned 
(CV, BASL.H, and CH) as described in the section 
— Output Within the Scroll — 



GETLN prints the prompt character and initializes X-reg for 
indexed storage of the input characters into the i 
Control then goes to NXTCHAR. 



NXTCHAR 
[$FD75] 




I- 651] 



This is the top point in the character input loop. RDCHAR 
is called to got a character into the A-reg. On return the 
A-reg is tested for presence of the control-U (right arrow on 
the keyboard) and if it is found, the A-reg is then loaded 
f™. f-h* refresh memory ((BASL).Y), assuming that 



; contains the sane value as CH 



If the A-reg value is $E0 or greater, the lower case letter 
is converted to upper case by AND with $DF. The character is 
then stored from the A-reg to the input area. 



If the character is a carriage return, CLREOL is called to 
clear to blanks the rest of the window line, and then a 

conditional branch transfers control to COUT so that the RTS 
exit of COUT will return control to the colling program with 
the X-reg indicating the input character count +1. That is, 

^^ll^^p^^lS^^^^ through mm, x - 



" c ed to the NOTCR routine for display on the output 



:ect 





Routine Description 



NOTCR 
i $FI>3D 
1648291 



This routine receives control with the character of interest 
in (IN,X). The current setting of INVFLG is saved on the 
stack, while INVFLG is set to $FF so that the character 
"echoed" to the screen will be white on wwv_ Wtik 
called with the character in the A-reg. 



On return from COUT, INVFLG is restored from the stack. 

[N,X is then tested for either of two special 




If Backspace, go to BCKSPC. If Cancel, 




If (IN,X) is neither Backspace nor Cancel the value of X-reg 
is tested to determine whether the input area is full or 
almost full. If there are more than 247 characters in the 
input area, a call to BELL is used to sisnal to the operator 



* / * * a 



1 to BELL is used to 
that the area is almost 



NOTCR 1 
| SFD5F 
[64863] 

I- 



CANCEL 
|$FD62] 
| M 866 1 
[- 670] 



After or without the margin warning bell, this routine ge 
control. Here, the X-reg is incremented to point at the 
next location in the input area to be filled. If, howeve 
the result is overflow to zero, then entry of the Cancel 



is s 



into 

after incrementing the X-reg, control goes back to NXTCH 
to continue with character input and " — 



This routine prints a back-slash through COUT to indicate 

the action taken to the operator. Control is then passed to 

GETLNZ to initialize for entry of a new input line - the old 
one is gone. 



BCKSPC 
[$FD71J 

[64881] 

I- 655] 



On entry to this routine, the backspace character has 
already been printed through COUT with resulting backward 
movement of the cursor. If the current value in X-reg is 
2ero, control is transferred back to GETLNZ for printing 
prompt and re-initializing for line input. Otherwise, the X- 
reg is decremented with control going to NXTCHAR 
input of characters. 




s routine calls RDKEY to get the next character placed 
into the A-reg. If, on return, it is found that the Escape 
key has been pressed, this routine calls the appropriate 
routine for reading the next character and performing the 
requested Escape key function. In the Old Monitor, control 
is passed to the ESC1 routine for this purpose, after a 
to RDKEY to read the next character. In the Autostart 

Monitor, detection at RDCHAR of an Escape character tra 
control (via ESC including RDKEY) to ESCNEW, which has the 

capability of handling multiple escape functions after a 
single depression of the Escape key. 



After any requested escape functions have beon performed, 
control returns to RDCHAR as if there had been no 
interruption. 




RDKEY 
( $FD0C 
[64780 
[- 756] 



This routine picks up and saves in the A-reg the character 
from the screen refresh memory area at BASL,H,CH (leaving 
the Y-reg filled with the contents of CH). It then changes 
that character in memory to blinking to indicate current 



KEYIN 

1$FD1B 
64795] 



l- 



ESC 

[$FD2F] 
[- 721] 



.ne asks for the next input character to be placed 
in the A-reg by doing an indirect jump via KSWL,H, which is 
-lly pointing at KEYIN. Return is therefore to the 

r of RDKEY, not to 



This is the routine which gets the next input key from the 

keyboard hardware. There are two required actions and two 
extra actions taken by this routine. The required actions 

are reading the keyboard input buffer over and over again 

until it is determined (by presence of the $80 bit) that a 
character has indeed been read. In this case, keyboard input 

buffer refers to the $100 byte "buffer at $200, and not to 
the location at $C000. The sign flag is set or not by 
checking the status of the value at $0000. If that value is 
positive, the routine loops back to KEYIN. If that value is 

negative, the value of $C000 is picked up and the keyboard 
strobe is referenced to prepare for the next keyboard Input. 

The auxiliary actions taken by this routine are first, to 
count up the random number field, ignoring overflow, and 



second, to restore to the screen area the 
by the RDKEY routine to remove the blink, 
accomplished by storing the A-reg at 
RDKEY loaded it. This is accomplished 
register is read into the A-reg, 




character modified 
This restore is 
% asst 
! the 




turn to the caller (of RDKEY) Is accomplished by an RTS. 



This routine is entered from RDCI1AR if the A-reg is found to 
contain the Escape key code. It reloads the A-reg with a new 

key by calling RDKEY. In the Old Monitor, it then calls ESC1 
to perform the requested single function. In the Autostart 
Monitor, ESCNEW is called to perform the requested functions. 
In either case, ESC is positioned such that the RTS which 



ESCNEW 
[$FBA5] 
[64421] 
[-1115] 



W^^^J^S^g^tiMt^S^S^ data** 
transfer; the Escape key functions I, J f K, and H. If the 

kpv n P yf nressed is one of these four, fhP .nnrnnrlstP "nln" 

functions C, B, A, and 

J, RDKEY is ; 



■ 



function < 



ctively) is 
ed to get 






If the key pressed is not 1, J, K, or M, then 
entered by JMP instead of JSR so that the RTS wi 
the caller of ESCNEW instead of to ESCNEW. 

In the Old Monitor this routine is called by the RDCHAR 
routine if the Escape key code is found in the A-reg by that 

it depending on which key is pressed next. 



:NEW translates I, J, K, or M to C, B, A, or D 
respectively before calling ESC1, which returns to ESCNEW. 

If the key is other than I, J, K, or M, then ESCNEW JMP's to 

ESC1 with Carry set, to have the appropriate function 

performed. In this case, Che next RTS will 
to the RDCHAR routine. 



When ESC1 is called, the contents of the A-reg (and the 
condition that^Carry is ^' secM > * ndi <j*^ th * ^^j^ b ® h 

n i 1 t » . i r> , . i 



i to move the cursor 
ta, or to clear all or some of the 
?i nation of these. 



CALLS TO KEYBOARD INPUT ROUTINES 

Tlx* following paragraphs describe how to set up for calls to the 

various entry points in the Monitor for keyboard input, and what the 
results will be. 




WWm Write carriage return and prompt character, then read a line. 
Set-Up: 

X-reg, Y-reg, and A-reg are insignificant. 
CH is insignificant. 

CV should point to the line in the Scroll Window where 

input is tc begin. 
BASL,M is insignificant. 

Results: 

CR is written, scroll takes place if appropriate* 
Prompt character is written through COUT. 

Keyboard is read character by character. Each character 
is placed at $0200, X and X is then incremented. 



iracter is "echoed" to Che screen at cursor 
position and the cursor is then advanced. 
On reading a carriage return, control is returned to 



calling 



On Return: 




iage return code 




carriage return, 

Y-reg contains com. .mils oi -mtimuin* 
Location $0200, X contains a carriage return. 

CH contains zero* 

CV contains line number, current value. 

B ASL , H contains memory address for CV, WNDLFT. 

Window line is blank to the right of the end of 




Write prompt character, then read a line. 

Set-IJp: 

X-reg, Y-reg, * 
CV and BASL,H 
Window. 

CH indicates where on that line the prompt character is to 
be placed, to be followed by the echoed key input. 

Line address at which input is to begin must be in 

BASL,H. The Line number in CV will be calculated and 
set in BASLjH after a carriage return has been entered. 



, with noted exception. 




et-Up: 

X-reg should be zero to begin storing 

Y-reg and A-reg are Insignificant. 

CV and BASL,H should be compatible, p< 



ng in the Window. 



: is to 




Note: For all the above, F,scape key functions are supported as 

described in the reference material for the Monitor you have installed. 
Also, control-U (right arrow) is supported. When that character is 

the contents of the screen memory at the current cursor position. 



Routine 



r 



ROCHAR Read single character thru KSWL: return to caller in A-reg. 
Set-Up : 

X-reg is insignificant, and will not be clobbered. 
Y-reg is insignificant. 
A-reg is insignificant. 

f and B ASL , H should be compatible, pointing in the 



ults: 

The screen character at the cursor position (BASL),(CH) 

will be set to blinking until a key is pressed. 
If the Escape key is detected, the appropriate rout I lies 

will be called to handle the requested function. 
Cursor right arrow (control-U) will be returned to the 
calling program, not the contents of the screen at the 
cursor. 

Cursor left arrow key (control-H) will be returned to the 
calling program. 

iaracters read from the keyboard will not be stored in 
the $02?# area, 
er the character is read, the blink will be turned off 

at the cursor position, but the key just read will not 
be echoed to the screen, nor will the cursor (CH) be 

advanced. 

Cancel input line (control-X) service is not defined 
as the data is not being stored in the $0200 area. 

special note is taken of carriage return, because the 
rest of the Monitor KF.YTN Routine is not called- It is 
up to the calling program to take appropriate action on 
entry of a carriage return. 



A-reg contains the value of the key pressed. 
Y-reg contains the contents of Gl. 
X— reg is not affected by the routines called. 
CV , CM, RASI.,H will have changed only if an Escape key 
function has been utilized. 

Read single character thru KSWL: return to caller in A-reg. 



t-Up: 

X-reg, Y-reg, and A-reg are insignificant. 

CV and RASL,H should be compatible, pointing in the 

Scroll Window. 

CH indicates the horizontal position where the cursor 

■ 





e character on 
to blinking. 
CEYIN routine is 

reading of the key" 
loturn (RTS) in KEY IN retu: 



:ion is set 




» not 



KEYIN 



Return: 

A-reg contains the character from the keyboard. It nay 

be any character, including Escape, carriage return, 
right or left arrow, or any other control character. 

X-reg is unchanged from the call. 

Y-reg contains the contents of CH* 

The character in the 

has been restored to 

to blink by RDKEY. 
CV is used to. calculate the new line. 
BASL,H reflects the recalculated address. 
CV remains unchanged. 

Kead single character from keyboard: return to caller in A— reg 




Set-Up: 

X-reg is unused and unaffected across this routine. 

A-reg input to this routine is what will be stored into 
the screen area at the cursor position (BASL),Y to 
remove , the blink condition after a key Is pressed. 

Y-reg is set to be used to store the A-reg into the screen 
area to remove the blink at (BASL),Y. 

CH and CV are not referenced, but should be appropriately 

*- T3ACT II 1 J-,. (U^J e~ * A—^^r, V_ r~r. 



are 



On return to the caller, only the A-reg has been \ 
It contains the input from the keyboard register. 



KEYIN ROUTINE REPLACEMENT 

There are cases in which it is desirable to replace the physical 
keyboard input routine with a routine which either reads from the 
keyboard and preprocesses the input, or gets the information to feed 
to rhe reading program from some source other than the keyboard. The 
requirements of such a program in replacing the KEYIN routine are 
described below. Placing the program / rou t i ne into effect is 

accomplished by storing the entry point in KSWL,H. 



ire replacement routine should manage the following resources as 
ndlcaccd . 



X-reg 




whatever source is to 



Must be unaltered. Save on entry and restore on e> 
it must be used by the replacement routine. 



.t if 



Y-reg 



Use as indicated above for A-reg. 



CH 

CV 



It must not be changed on return from contents on entry, 
so save and restore if it must be used otherwise. (This 

caution is not required, however, if the source of the 
input prevents Escape key and right arrow from being 
entered- In such case, the Y-reg is expendable.) 

These are all used for echoing the "keyboard 1 ' input, 
so the replacement routine should either leave them 
alone or n 



■ 

them in an appropriate manner. 



NOTE: On replacing the pointer to KEYIN at KSWL.H, it is generally 

safer to pick up and store the current contents of KSWL,H in a 

save area before placing the address of your routine, and then 
restore KSWL,H from that save area when taking the replacement 

routine out of service. 



NOTE: If you replace the < 
routine while 

CSWL,H and KSWL.H, and periodically restores them to appear the 
way DOS likes to see then regardless of curren 

Depending upon your application, it may be a g 

replace both pointers on a temporary basis so that echo to the 
screen will not pass through DOS. But 

soon as possible. 



KEYBOARD INPUT MONITOR ROUTINE 



TluTi' are many points in Keyboard Service which a user program could 
iino fully call. However, because they are generally different locations 

m <» continuous string of instructions, and all instructions after the 
point of entry will be used, sections of this table of addresses are in 
Monitor .sequence rather than in sequence by potential usability. 



Nm.- that once the Monitor is jumped to at the specified point, all of 



This Is Implied by the 6 at the en 
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Function 



Ilex +Dec -Dec ?tonitor Resist* 
Addr Addr Addr Label bestrov 



BOTH MONITORS 

Call RDKEY to get next character 
Into A-reg. 

Compare to $9B (Escape). 
If = BR to ESC to call for next 
character and do Escape 
Else, RTS- 
Set screen to blink at cursor 
saving original character in 
A-reg from (BASL) ,Y 
Jump Indirect (KSWL) tc KEY IN 

Increment random number at RNDL,H 
while polling keyboard register* 

Store A-reg to (BASL ) ,Y (clear 
blink set by RDKEY routine). 



FD35. 64821 -715 RDCHAR A,Y 



FD0C 6^.780 -756 RDKKY A,Y 



FD18 64792 -744 



FD1B 64795 -741 KEY IN 



A 
A 





A 




Escape key service. 



@ HOtfK 
A ADVANCE 



D UP 

E CLREOL 
F CLREOP 
other 



clear scroll 
cursor right 
cursor left 
cursor down one line 
cursor up one line 
clear to end of line 
clr to end of window 
ignore: RTS 



et port $ (kt»yb 



unit. FE89 65161 



ONLY 

for Escape key service & FD2F 
Call ESCi with character in A-reg 
and Carry set to do indicated 
function. Return is to RDCHAR* 




64815 -721 ESC 



A,Y 
A,Y 



AUTOSTART MONITOR ONLY 

Call RDKEY for Escape key service & FD2F 64815 
Call ESCNEW with character in 

and Carry set to do indicated 
function. Return from Escape 

to RDCHAR (above). 



-721 ESC 



A,Y 



Function 



Hex +Dc»c -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Set Carry flag and JMP to ESC1 

to handle Es 
A, B, C, D, E, 



FB97 64407 -1129 ESCOLD A,Y 



Handle Escape key functions 
I, J, K, M. Translate to 
D, B, A, C and call ESCOLD. 

Then RDKEY to get next character 
and drop into F.SCNEW to continue 
Escape key processing. 



Escape key processing entry point. FBA5 64421 -1115 ESCNEW A,Y 

If A-reg contains I, J, K, or M 
t hen go to ' ^ ' ' 1 ■ " 1 ** 1 " - a 1 ■■ 



to translate 

and handle it with return to 
ESCNEW. Otherwise go to ESCOLD 

to handle this entry and exit 

>_ — ■ 



i r 





Logically speaking, the place to start below is CETLNZ , but the 
sequence of presentation here is the sequence of instructions in the 
Monitor because of heavy use of "fall into" next code segment. 

Note that once the Monitor is jumped to at the specified point, all of 
the initialization described after that entry point is also performed. 

at the end of each function description. 



Echo keyboard input thru COUT to 
the screen, from 1N,X, with 
INVFLG temporarily set to $FF. 

Pick up character from IN,X; 
if $88 goto BCKSPC. 
t f $98 goto CANCEL. 

if X-reg (input index) greater 
than $F7 fall into FP5C. 

Else goto N0TCR1, bypass Bell. 
Sound bell if X indicates 248+ 

i npu t ch a r ac t e rs . 
Increment X-reg; 

If X not zero eoto NXTCHAR. 

if X-0 fall into - 



-Dec Monitor Registers 
Addr Label Destroyed 



FD3D 64829 -707 NOTCR 
FD4D 64845 -691 



FD5C 64860 -676 

FD5F 64863 -673 N0TCR1 



A 



X 
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Function 



Hex +!>ec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Load SDC C\) into A-reg. 

Backward slash indicates 

input cancelled. 
Call COIIT to print A-reg. 

Then fall into CETLNZ . 
Print carriage return thru 
Load PROMPT into A-reg. 
Call COIJT to print A-reg. 
Load X-reg with $01 for pa 

thru backspace operation. 
If X=# goto GETLNZ to start over. 

Else, decrement X-reg and 

fall into NXTCHAR. 
Call RDCHAR to get next character. 

If character received is ctrl-!I 

($95, right arrow) pick up the 

screen character from (BASL),Y 

to replace it in the A-reg. 
If A-reg greater than $DF, then 

AND against $DF" to make it 
upper case. 

Store A-reg to input area at IN,X. 

Compare to carriage return. 
Goto NOTCR (above) if not. 
Else, call CLREOL to clear the 

rest of the line, then print 
carriage return thru COOT, 

using RTS from that function to 

accomplish return to caller of 
keyboard input. 



FD62 64866 -670 CANCEL A,X,Y 



& 

FD64 

& 

& FD67 
& FD6A 



64868 -668 



64871 
64874 



-665 
-662 




CETLNZ A.X.Y 
A.X.Y 

A,X 

m 












IN 



=$0200, keyboard input area, 
is at $32 



OVERVIEW— TEXT OUTPUT TO THE SCREEN 

The highest level of support in the Monitor for text output to the 
screen is scroll device support. In addition, the Monitor contains 
many components which support use of the screen in a formatted manner. 
Because there are so many ways to write text to the screen, the topic 
of screen output has been divided into the following sections: 

TEXT OUTPUT WITHIN THE SCROLL WINDOW 

describes the normal manner of text output, defining the fields in 

page zero which are used to control this function, and which are 
used in the descriptions in the following sections. 



- 



SCKRKN FORMAT CONTROL 

identifies the entry points by means of which display 

(full text, full graphics, nixed LORES graphics and text), Scroll 
Window setup, and character display mode (black on white or white 

on black, or b" 

SCROLL WINDOW DATA MANIPULATIONS 

describes Monitor calls which clear all or part of the Scroll 

Window, set parts of the window to some user specified value, or 
cause conditional or unconditional scrolling of the window. 



CURSOR POSITION CONTROL 




TO THE SCREEN 

describes the Monitor entry points to output user program 

data to the screen or to the current output device if 




% has been modified- Also, entry points are described to 
transmit standard types of output (blanks, bell code, carriage 

return) to the output device (general] 



TEXT OUTPUT WITHOUT THE SCROLL WINDOW 

describes the entry points used for placing characters 
screen outside of the Scroll Window, and for reading the k 
when echo to the Scroll Window is to be performed. 

SECONDARY DISPLAY AREAS 




limited Scroll Window functions sue- ' " ~ i^iM* M 

echo to go to the Secondary area. 

Any entry point which fits into more than 
In each appropriate address table. 



OUTPUT WITHIN THE SCROLL WINDOW 




Scroll Window operation is compatible with printer or t; 

output in that new characters are displayed to the right 
output, and new lines are displayed below previous lines. It is this 
mode of operation which Is described in this section. That is, this 
section describes "printing" information by means of the CSWL vector 
to the screen or to a printer type device. The section on General Text 



to the 




i describes use of the screen, bypa 
direct use of the Scroll — - ■ 




vector 



The normal method provided in the Apple II for displaying output 
information is by "calling" COUT with the character in the A-reg for 



each displayable character or format control character (such as a 
carriage return). At COUT, a JuMP Indirect is done via the CSWL 

2 the character on the selected medium 
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function- When the system is 

is set to point to C0UT1 which supports 

sen. If the user sets a different 
output device (by PRffn in BASIC or ctrl-P in Monitor node), then 

CSWL vector will be set to pass the output bytes to the selected 

peripheral controller card instead of to the screen. Depending on 
which peripheral controller card, and which controls are active, the 
program on that card may place the " ' 



and 



to ■ 



The nomal siode of text output to the screen is in "scroll" mode- Tn 

this mode, new information is written to the bottom line of the 
screen, and the contents of the screen are moved up, up, and away as 
equlred to allow entry of new information below the old. This mode of 

output is used in APPLESOFT or BASIC "PRINT" statements. This is the 
mode of output used by any Monitor command which displays data to the 

screen. 



As new characters arc written to the screen, they are placed at the 
position of the cursor. The cursor position is a location on the 

screen (and in screen refresh memory) specified by the contents of 
certain fields in page zero. Also, the Scroll Window is a portion (or 

all) of the screen as defined by the contents of certain fields in 




the scrolling function. 



The fields in page zero describing the Scroll Window indicate the left 
column and width. *nd thp ton and hot ton. linos, as described here. 



, and the top 



bOttOTP 



The cursor position is defined in various fields, 
program interferes they will be compatible. 

The screen line number of cursor position is contained in the field 
CV. CV indicates the line number of the cursor relative to the top 
line of the screen, not the Scroll Window- (Note that this Is 
different from CH, described below.) The screen refresh memory 
location which corresponds to this line number ia maintained in the 

two byte field (BASL,H). Note, however, that if the left edge of the 
Scroll Window is not the leftmost character of the screen, BASL,H will 
have been adjusted to point to the leftmost character position on that 
line within the Scroll Window. Thus, a program may interrogate CV to 
determine the line number of the cursor, but the program cannot just 
S a different line number into CV to move the cursor as BASL , H must 




The horizontal position of the cursor is maintained in CH. The value in 
CH is relative to the left edge of the Scroll Window, not necessarily 
to the screen. When a character is being "written" or "printed" to the 
screen, the routine which places the character in screen refresh memory 
uses the Y-reg for horizontal position, in the assumption that it has 
been loaded from CH. In the address table, each description indicates 
whether the routine 



uses CH or 
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For machine language programs. Scroll Window output is most easily 

accomplished by a JSR to COOT at $FDED (-531) with the byte in the A- 
reg. From BASIC the same thing is accomplished by PRINTing a -y 
in which the byte has been stored. In BASIC, of course, a wh 
can be written with a single command. 

As the characters are passed through COUTl, they are modified, if 
necessary, to be written in white on black, black on white, or 
flashing, in accordance with the contents of the field called 
This field can be set (POKEd) at any time, and is immediately 
effective on all future characters printed by the program until It is 
again modified- This function only applies to program print output. 
During keyboard entry, INVFLG Is temporarily changed to $FF as each 
input character is echoed through GOUT. 



The two byte field BAS2L,H is described below although it is rather 
useless for user prograa reference. It is a work area used only 



: ZERO FIELDS 




Dec Hex Routine Description 



32 $20 WNDLFT 



Left column of the Scroll Window: 
Range is 9 to 39 ($27). 

This field is used only in VTABZ. The contents, 
when changed by user program, become effective on 
the next scroll operation, clear to end of page 
operation, or carriage return output. CH contains 
cursor horizontal position relative to (WNDLFT). 

After changing the contents of WNDLFT, either CALL 
^ or output a carriage return to make it take 



WNDWDTH 



Width of the Scroll Window: 
Range is 1 to 40-(WNDLFT). 

When a character is written through COUT to the 
screen it is placed at (BASL),(CH), after which 
is incremented. At that time (CH) is comi 



(WNDWDTH) to determine whether the cursor has 

:he ritrht marpin of the Scroll Window. 



exceeded 



34 



Top line of the Scroll Window: 
Range is to 22 ($16) for full text screen. 
Range is 20 to 22 
and text. T 
operation to 

start . 




rot tun text scieeu. 
2 ($14 to $16) for mixed graphics 

fit, I.I 1o i,cr-A .1, ,»-;.,,, a c .»rn1 1 
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Bottom line of Scroll Window +1: 
Range is (WNDT0P)+1 to 24 ($18). 

WNDBTM indicates the first line number below the 
window. Contents of WNDBTM are tested only on 
: a carriage return ($8D) or line feed 
($«A). It is used by Clear to End of Page and by 



Displacement from WNDLFT where t 
the screen will be placed: 
Range is to (WNDWDTH)-l. 

After the screen output routine STOADV places a 
character into the screen area as part 
character output, CU is then incremented 

to WNDWDTH. If CH is not low then a 
return 





Note that CH is used for echoing keyboard input to 

the screen by the Monitor routines GKTLN etc., 
because COUT is used. 



Vertical screen position (line number) for next 
character to be wriLten to the screen: 
Range Is to 23 ($17). 

The content of CV is relative to the top of the 
screen, not to the top of the Scroll Window. It 

may be set by loading the desired line number into 
A-reg and calling TABV. It may be set by POKKing 
the line number into CV and then calling VTAB. 
Actual storage of a character into the screen area 




each. 



below WNDBT7-! , it will remain on 
t carriage returns go by while the 




two byte field is the memory address for the 
t end character position of the current text 
line, within the Scroll Window. The contents are a 
function of CV and WNDLFT. 




This field is set by the BASCALC routine to 
to the memory address for the left end of the line 
specified in the A-reg. This call to BASCALC 
usually accomplished by the VTAB routine, 

then adds (WNDLFT) to BASL,II to point to the 
end of the line within the window. 





This two byte field is used as a work area only 
during a scroll operation. It is the destination 
line pointer used as each line ie moved to the 



50 $32 INVFLG 



This byte is a mask used by COUT I to cause 

characters written to the screen area to display 
white on black (INVFLC«$FF) or black on white 
(INVFU>$3F) or flashing (INVFLG=$7F) . This field 
is set to $FF when a RKSKT occurs by the routine 
at SKTNORM. The routine called SETIKV can be 
called to set reverse video. The Monitor does not 



$35 YSAV1 




INVKLC~$7F does not cause all characters 
lash: the upper Z bits of the character must be 
for flashing to occur. 




This byte is a save area for the Y-reg across a 
call to the screen output routines. Y-reg is saved 



aid contains the address of the 

to receive and dispose of output 

characters. When the RESET key is pressed, this 
field is initialized to point to C0UT1 to send 

output characters to the screen. Entering a 

Monitor Command nPc (n=port number, Pc=control-P) 

will cause the Monitor to set CSWL,H to Cn00. The 

routine at that location will then receive (in the 

A-reg) ^each^byte "written" through COUT , which is 




SCROLL WINDOW OUTPUT ROUTINES 



Ilex +Dec 
Addr Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



Jump via CSWX, character p 

Write byte in A-reg to « 

cursor (CV),(CH) 
supporting cursor m 

Write byte in A- 

(CV),(ClO with 
not INVFLG. 





none 




■ 



none 



■ 
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Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroy**'' 



Print carriage return thru COUT. FD8E 
Print thru COUT "ERR" and bell code.FF2D 



Print bell code ($87) thru COUT. 
Set BASL,H from CV (and WNDLFT). 

Set BASL.H from (A) and WNDLFT 

without regard to CV. 

RASL,H to ***** — ' 



FF3A 
FC22 

FC24 



65325 

65338 
64546 

64548 



-211 

-198 
-990 
-988 



line (not window line) in A-reg. 



— - 



■ 



CV 

GBASL,H 

BASL,H 

INVFLG 



36 




$24 


WNDLFT 


32 


— 

$20 


37 


$25 


WNDWDTH 


33 


$21 


38-39 


$2 6-2 7 


WNDTOP 


34 


$22 


40-41 
50 


$28-29 
S3 2 


WNDSTM 


35 


$23 



CROUT 

PRRRR 

BELL 
VTAB 

VTABZ 



A^ 
A 

A 
A 

A 









Function 



roll Windo 



Clear HIRES graphics mode. 
Set display area primary. 
Set TEXT mode. 

Load into A-reg For WNDTOP, 
branch to SETWND below. 



Window configuration. 



Hex +Dec 
Addr Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



& FB33 
& FB36 
& 



64307 
64310 
64313 
116 



•1229 
•1226 



A 

A 



Set Graphics mode. & 

Set mixed graphics/text mode. & 

Call CLRTOP to clear graphics. & 

Load 20 ($14) into A-reg for set & 
of WNDTOP. Fall into SETWND. 



Set top line of window (WNDTOP) 
from A-reg, or 20 or user set 
Fall thru following. 

Load A-reg with for WNDLFT. 

Store A-reg to WNDLFT. 

Load A-reg with 40 for WNDWDTH. 

Store A-reg to WNDWDTH. 

Load A-reg with 24 for WNDBTM. 

Store A-r«*g to WNDBTK . 

.oad A-reg with 23 for VTAB. 

to CV. 





64320 
64323 



64329 



-1216 SETCR 
-1213 




& 


FB4D 


64333 


-1203 


& 


FB4F 


64335 


-1 201 


& 


FB51 


64337 


-1199 


& 


FB53 


64339 


-1 197 


& 


FB55 


64341 


-1195 


& 


FB57 


64343 


-1193 


& 

& 


FB59 
FB5B 


64345 
64347 


-1191 



A,Y 



mm 64331 -1205 SETWND A 



A 
A 
A 
A 
A 
A 
A 



n 



Hex +Dec -Dec 
Addr Addr Addr 



Monitor Registers 
Label Destroyed 




for TNVFLG 

Fall into 
Load Y-reg with S3F for INVFLG. 
1 to SETIFLG. 



Store Y-reg in INVFLG and RTS. 

$p! white on black (from SETNORK) 
$3F black on white (from SETINV) 

$7F flashing (characters from user call with upper 2 bits of 01) 



Set CSWL,I1 to point to C0UT1. 



CH 

CV' 

TNVFLG 
IIASL.IJ 



36 $24 

37 $25 
50 $32 
40-41 S28-29 



CRWL.II 54-55 




FE93 65171 -365 SETVID 
. 



WNDLFT 
WNDWDTli 

WNDTOF 



32 
33 

.4 



A,X,Y 
— 



$20 
$21 



SCREEN FORMAT 
BY POKE/STORE 




En many cases, the routine in the Monitor described on the previous 
page exists because the Monitor itself uses the function described. 

Often, calling the Monitor for a specific control function is doing it 

the hard way. This table indicates other ways of accomplishing the 



Kuiict ton 



Method 



_ 



Set GRAPHICS display mode. 
Set TEXT display mode. 
Set GRAPHIC? mode to full screen. 
Set MIXED GRAPHICS and TEXT mode. 
Set ^splay to |gg|| Area. 

Clear HIUES/So.t' LORES fc 
Set HIRES Graphics mode. 
Set top line of Scroi; 

Set left edge of Scroll Window. 

Sot width of Scroll Window. 

m-. 

Set Normal (white on black) text. 

Sot Flashing text. 

Sot Inverse (hi rick on white) text 



POKE -16304,0 or 

POKE -16303,0 or 

POKE -16302,0 or 

POKE -16301,0 or 

POKE -16300,0 or 

-16299,0 or 

-16298,0 or 

-16297,0 or 



STA C050 
ST A C051 
STA C052 
STA C053 
STA C054 
STA C055 
STA C056 
STA C057 



34 .line-number (0-23) 

Bottom must be greater than top. 

POKE 32, column-number (0-39) 

Left edge + width not to exceed 40. 

POKE 33,nuiriber-of-columns (1-40), 

Left edge + width not to exceed 40, 

POKE 35, line-number (1-24) 

Bottom must be greater than top. 

POKE 50,2 55 or store $FF in $32 
POKE 50,127 or store $7? in S32 

POKE 50,63 or store $3F in $32 



If the above means are used to change the Scroll Window configuration, 
the user program should also take steps to insure that the cursor has 
a^valid posicion within the window (CV, CH, BASL,H) . CALL -936 will 



and $C051 control Text mode vs. all or some graphics. The other 
ems regarding HIRES or LORES or full or part screen graphics may be 
established first, but will not be apparent until $C050 is tickled. 

likewise, $C051 will bring back Text Mode regardless of the other 
settings. 



SCROLL WINDOW DATA MANIPULATIONS 



This table describes three types of Scroll Window data manipulation 
entry points. The first is Monitor label ESC1, the Escape Key 

Processor, because it transfers control to a number of the other entry 
* its depending upon the A-reg contents and Carry being set. One 
y point of the £^ star £ Monitor is included because it handles 




1 or 





screen ; 

If Carry is set 

p goto HOME 

A goto ADVANCE 

B goto BS 
C goto LF 
D goto UP 

E goto CLREOL 
F goto CLREOP 
other RTS to caller. 

The RTS at the end of 
these functions returns 
to the caller of ESC1 . 



JC1 



A 



1 
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Kex +Dec 
Addr Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



- 



Clear from line (CV) col (CM) to 

end of Scroll Window- 
Clear from line (CV) col (Y) to 

end of Scroll Window. 

Clear from line (A) col (Y) to 

und of Scroll Window, 
clear Scroll Window to blanks, 

set cursor to top left corner 

of the window. 
Set C11=0, CV=(A), clear bo EOF 

(end of page = end of windc 
Clear window from line 1 

blank, set cursor to 1- 

1 Ihe (CV). 
Clear line from cursor 

( (KASI.),(CH)). 
Clear line from cursor (BASL 
Set character in A-reg from 

cursor (BASL) ,Y to EOLine. 

Clear line (BASL), then set 

UASL,H from CV and WNDLFT. 
Clear line from cursor (BASL) ,Y, 

then set BASL, II from CV 6 
CII remains unchanged. 

7-ero to A-reg for CH. 

Store A-reg to CH. 
Increment CV » 

Compare CV to WNDBTM. 

Set BASL ,11; if (CV) < (WNDBTM), 
do scroll if required. 

Scroll the window, lines (CV) 
thru (WNDBTM) . 

Scroll the window, |j 
through (WND 



Au tostart Monitor extended service 

Sot Carry flag and JMP to ESC1 
to handLe Escape key functions 

. <3£ n. r, -r, 

A, R, 







Y 



FC44 



64580 
64582 



-956 




. • ■ 



F( 



FC95 
FC97 



64661 
64663 



-875 SCRL3 



-873 



& 
& 



FC62 
FC64 



646 10 

64612 
64614 



-926 
-924 



R 



& E, F. 



A,Y 



-954 CLE0P1 A, Y 



6 



A, Y 



64672 -864 CLE0L2 A, Y 



A,Y 



A,Y 



A,?Y 

A,?Y 
A,?Y 

_ 



FC70 64624 -912 SCROLL A, Y 



FB97 64407 -1129 ESCOLD i 




CII 
CV 

INVFI.0 
KAS1.,U 



36 
37 



$24 
$25 



WNDLFT 
VNDWDTH 




32 
33 



$20 



. 




CURSOR 




CONTROL 



In general, the Cursor is at the position indicated by the contents of 
CV (line number relative to top of screen) and CH (column number 
relative to to the left margin of the Scroll Window). The memory 
location of the cursor is the sum of the contents of BASL,H (which 
contains the address of the leftmost character of the line within the 
Scroll Window) and the contents of CH. Normally, then, BASL,H containi 
an address computed from the contents of CV and WNDLFT. However, If 
either CV or WNDLFT is changed without recomputing BASL.H then the 

routines of the Monitor may come up with unpredictable (or 

at 




In the following table, the description Includes indication of which 
of the cursor address fields is being used for what. Note, for 
example, that at $FC95 the line indicated by BASL , H is cleared, and 

* ' - - 1 i j ..... £y : i _ . . 



■ 



The ESC1 and VTDOUT routines are included in the table because they 
can be made to use (goto) the other entry points by passing them the 

appropriate A-re£ contents on entry. VIDOUT is the routine which 
handles CR, backspace, and line feed when such characters are sent 
through C0UT1 (generally thru COUT). ESC I is the routine called 

accomplish the desired function when the keyboard routines are 
operating in ESCAPE key mode- Thus, it has four way cursor mo 1 
capability, as well as the capability of clearing the Scroll Window 
from cursor present position to end of current line or end of the 
>11 




due to its relationsr 




the to 



1 



m as move I 




on the 



The third group is entry points : 
relative to its current position. 




The fourth group supports positioning the cursor at a desired location 
without reference to its current position. To do this, the program 




TABLE 



Cn I 1 screen/cursor manipulation. 
If Carry is set and A-reg = 



P 

A 
11 
C 

n 

K 
F 



goto 

goto 
goto 
goto 
goto 
goto 

goto 



HOME 




other RTS to caller. 

The RTS at the end of each ._ 

Lliese functions returns control 
to the caller of ESC1. 
Sot Carry flag and JMP to ES( 
t<» handle Escape key 
A, It, C, D, E, F. 




If (A) > S9F or < $80 e 

If (A) = $8D goto CR. 

tt (A) = $8A goto LF. 

If (A) - $88 goto BS. 

If (A) = $87 sound "bell". 

If (A) - other ignore it; RTS 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



_ 




mm 




— — 








-1! 



CI oar Scroll Window, set cursor to 
top left corner of the window. 

%t 011=0, cv=(A), clear to EOP 

(rnd of page = end of window). 

CU-ar window from line (A) to 
blank, set cursor to left end of 
line (CV). 

Clrar line (BASL)> then set 
KASL.ll from CV and WKDLFT. 

Cli'.ir line from cursor (BASL),Y. 
mn set BASL, II from CV & WNDLFT. 



FC58 64600 -936 HOME 



A,Y 





Uorttl Y Iron CI I . & FBF0 

Siorr A-rog to screen at (BASL),Y & FBF2 
I lit'remenc cm. 

Cnnpfirr (CM) with (WNDV 
Koto VM If CM not less. 
Klue return (KTS ) . 

PMWt one column, to 

rlglir end of previous line if 



64496 -1040 STOADV 
64498 -1038 




A,Y 
A 

I 



-2i 
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Hex +Dec 
Addr Addr 



Dec Monitor Registers 

:royed 



& FC62 
& FC6A 
& 




FB5B 



Move cursor up one line 

if (CV) < (WNDTOP). 
Zero to A-reg for CH. 
Store A-reg to CH. 
Increment CV* 
Compare CV to WNDBTM. 

If CV not less decrement CV and 
do scroll. 

If CV less goto VTABZ to set 
BASL,H and return- 
Place cursor at line (A) col (CH) 

(store A to CV and set BASL,H 

by JMP to VTAB) . 

Set BASL,H from CV and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL,H from A-reg and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL,TJ to memory address for 
left character of line In A-reg 
(not left character of window). 



Jutnp via CSWL, character print. 

Character print to screen output 

routine entry - normal for 

Print character to screen with 

appropriate actions on controls 

control characters • 

If (A)<$A0 goto COUTZ, bypass 

inverse video mask. 
— ■ 

AUTOSTART MONITOR ONLY 



64610 
64612 




-1189 TABV A 



FC22 64546 -990 VTAB 



FDED 65005 -531 
FDK0 65008 -528 



A 

A,?Y 
A,?Y 



COUT ?A 
C0UT1 ?A 











Print character to screen via FDF6 65014 -522 

VIDWAIT (pause if operator request) 
and VIDOUT with save and restore 

of A reg and Y reg. 



— . 







OLD MONITOR ONLY 

Print character to screen via 
VIDOUT with save and restore 
of A reg and Y reg. 



— 
















m 

37 
50 




WNDLFT 32 
WNDWDTH 33 
WNDTOP 34 



$20 
$21 

$22 
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GENERAL TEXT TO THE SCREEN 



The preferred method of sending text to the screen Is by loading the 
character desired into the A-reg and calling COUT to handle it from 
there. The reason this is preferred is that if you want to send the 

output to some device other than the screen, you can change CSWL,H 
to point at the program supporting such other device. There are 

times, however, when you'll want to write to the screen 

the setting of CSWL.H. CO DTI is the entry point for sere 
output, where reverse video display or flashing characti 
uHtng r N VFLG * Entry at this point for the Autostart Monitor alsi 
fillows you to stop output, using the control-S key* 

COUTZ may be used for output to the screen without modifying the 

character by using INVFLG. That is, calling COUTZ with a character in 
the A-reg will place that character on the screen as Is, without using 
I NVKLG to display the character in inverse video or flashing mode- In 

.11 







contains a control-S. 



VIDOUT is the routine which interprets the character and places it on 
the screen If it is not a control character. If the VIDOUT routine is 

to be called directly (to bypass control-S handling in the Autostart 
Monitor, for example), then the calling program must save the A-reg 
mid Y-reg before and restore the A-reg and Y-reg after, because they 
jire both destroyed in the VIDOUT routine- 
Output to the screen may be written via these alternate entry points* 

However, note that the Monitor will still use COUT for the keyboard 
Input echo function, temporarily setting INVFLG to $FF for white on 

hl.-ick For each character echoed. 



Kol lowing are addresses of the 
other entry points which will output the specified character(s) (via 
COUT) without the calling program having to load them into the A-reg 
before the cal 1 - 



ADDRESS TABLE 

function Hex +Dec -Dec Monitor Registers 

Addr Addr Addr Label Destroyed 



Print a byte to specified output FDED 65005 -531 

device by JMP (CSWL), normally 

COIITl for screen. 
Character print to screen output 

routine entry — normal for CSWL. 

Print character to screen with 

appropriate actions on controls 

ji ml control characters. 

tf (A)<$A0 goto COUTZ, bypass 
inverse video mask. 
AND (A) with INVFLG. & FDF4 65012 -524 ?A 
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Hex 
Addr 



+Dec 
Addr 



Print a byte to the screen. 
See AUTOSTART and OLD differences 

toward end of this table. 
Process char, in A-reg to screen. 

If control character, do control. 

If display character, store in 
screen refresh memory. 
Store A-reg to screen at 

(BASL,H) ,(CH), then increment 

CH and goto CR if window exceeded, 
Store A-reg to screen at (BASL,H) / 

then inc CH and goto CR if window 

exceeded • 
Increment CH and goto CR if window 

exceeded. 
Test CH. Goto CR if CH => WNDWDTH. 

Tf A=SoP, S8A, $o8, or $87 do it: 
$SD carriage return goto CR 



-Dec 
Addr 

Zrrr-z 



Monitor Registers 
Label Destroyed 



64509 -1027 VIDOUT A, Y 



-1 



STOADV A, Y 



FBFA 
KRF6 



.4Z.98 -103 



64 500 -1036 

645^2 -1034 
16 -1( 



■ 



$8A line feed 
$88 bacV space 
S87 bell 
Set INVFLC to $3F - 

r FhC to $FF = normal 
/FLO from Y-reg 



goto LF 
Roto RS 
sound "bell" 
i nverse 




— 







FK80 

FF.84 

FE86 
~ 



65152 

65156 

65158 




-384 
-380 
•378 



SETINV 

SF.TNORM 

SKTIFI.C 








Print character to screen via 
VIDWAIT (stop if 
and VIDOUT with save i 

of A and Y regs. 
Test for ope. rat or pause reouest* 

If (A) = S8tl (carriage return)* and 

if keyboard register is full, and 
if keyboard reft contains cntl-S, 

then fall into KBDUAIT. 
Rise, goto VIDOUT. 
Pause system per operator request. 
Loop until new key pressed. 
If next key pressed is cntl-C 
then goto VIDOUT, leaving cntl-C 

in keyboard register. 

kevboard strobe and 

goto VTDOflT. 





FDFf> 



Y 
Y 

none 



-522 COVT 7. none 



-1160 VTWATT Y 



, 



H.n rroMiTOR only 

Print character to screen via 
VIDOUT with save and restore of 
A-reg and Y-reg. 



1 



■ 







OH 


36 


$24 


mmi.FT 


32 


$20 


W 


37 


$2 5 


WWDWDTH 


33 


$21 


INVFLC 


m 


$32 


WN1T0P 


34 


S22 


RASL,U 


40-4] 


$28-29 


WMDBTM 


35 


$2 3 
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Thr following control characters have special meanings for screen 
d I rtpl ay • 



Carriage Return 

In the Autostart Monitor, the COUTZ routine calls (J 
which handles the control-S function before jumping to 

Thr COUTZ routine in the Old Monitor calls VIDOUT. 





entry is other than a control-C, the keyboard strobe is c 
Otherwise the keyboard is left filled with the control-G 
calling program to detect and handle. Then VIDWAIT JMP's to 
V I DO UT . 



■ 



•';HA Line Feed 



The cursor is moved down one line unless this would put it on a 
line below the Scroll Window. In that case, the contents of the 
Scroll Window are rasved up one line, and the cursor stays on the 
current screen 



DOUT routine moves the cursor to the left one space by 
decrementing CH. If CH goes negative it is set to (WNDWDTH)-l 
CV is decremented. If decrementing CV would take it above (W 
CV is not decremented. Negative scroll is hot supported. 



$M Sound the Bell 

The speaker is pulsed 1000 times per second for one tenth of a 

second. 

Any other character in the range $80 thru $9F is dropped. It does 
not cause cursor motion or memory modification. 

OUTPUT WITHOUT THE SCROLL WINDOW 

II jill or part of the screen is to be used in a direct addressing 
iimimt-r, li Is necessary to avoid certain Monitor services. In general, 
l In* Si- ml I Window services provided by the Monitor are: 



I, Scroll all text in the window up one line it a carriage return 
or line feed takes the cursor down through the bottom line of 
t lu- wl ndow. 




3. Place the cursor at the left edge of the Scroll Window Inst 
of at the left edge of the screen on a carriage return. 



4. Support screen clear functions: 

A. Clear the window, place cursor at top 

D <->1 • I C — ... 



corner 



When using all or part of the screen as a random access c 
automatic services need be avoided. 

If the full screen is to be used as a random access display, without a 
portion being used as a working Scroll Windov, the problem is not too 
difficult. Consider leaving the whole screen defined as the Scroll 



1. 



- 



The scroll operation only occurs if a carriage return or line 
feed or exceeding window width occurs on the bottom line of the 

■ 

Scroll Window. Avoid this by not having the program output OR or 
LF or excessive data on the bottom line of the screen, and by 



keeping the cursor away from the bottom line of the screen 
keyboard input operations. 



2. The full screen is defined as the Scroll Window by the Monitor 
when the RESET key is pressed. A user program can restore the 
window parameters to this configuration if they have been 
altered by calling "Set Normal Scroll Window" at $FB3C or 6A316 
or -1220. 



3. Portion the cursor where ^sired before printing a string of 



I ine and then POKE the character number into CM. 




string of characters by the same means as if 
1 services, being careful not to unintentionally 
; width or output carr 1 



these* 



Note that program output of a carriage return does not clear the line 
to the right of the carriage return, but keyboard input of a carriage 
return does (if reading the keyboard is being done by the Monitor get- 



. . ■ 



different (lower) level of Monitor services must be called upon. 

One way to support a divided screen is by using the Scroll Window for 
data input with the Monitor get-input-line services, and by using the 
Scroll Window support for whatever output the program intends to put 
there. Then use parts of LORES graphics support for placing characters 

on the screen outside of the Scroll Window, as described below. Hie 



aim here is to leave support of cursor position (zero page fields CV S 
CH f and BASL,H) up to the Monitor, and use other methods/fields for 
placing characters outside the Scroll Window. 



To place characters outside the Scroll Window, 




1. With Y-reg indicating horizontal position on the line, store the 
desired character at (CBASL),Y. 

Note tha t thi s technique does not interfere with LORES plotting if the 

Hereon is being used in mixed mode, because PLOT calls always set 
<:i!ASI,,H as required without regard to possible previous contents. 



Another approach is available for the BASIC or APPLESOFT programmer. 
Again, the Scroll Window support can be used for some things, while 
tin- following approach can be used to place characters on the screen 

outside of the window. That approach is to compute the screen memory 
location for each byte to the screen, and poke the byte there. A 
variation on that approach is shown by the sample program. In the 
rminple, the Monitor VTAB routine is used to assist in building a table 
of memory locations indicating the starting points of the screen 
lines* This is an easier alternative than using the modulo arithmetic 
formula described in the section "Pages Four thru Eleven". Note that 
adding 1024 to each value in the table 
Hint line in the secondary display area. 



ADDRESS TABLE 



Kimc t ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



OUTSIT)!-" OF SCROLL WINDOW 

Compute memory address for line in F847 63559 -1977 CBASCALC A 
A-reg; set CBASL,H. 



INS I DP. SCROLL WINDOW 

supporting cursor move. 
Write byte in A-reg to screen at 

(<;V),(CH) with cursor move but 

not INVKLC. 
Clear Scroll Window to blanks, 

enrwor to top left corner. 
Set CV from A-reg, clear window to 

m\ m window. 




A . Y 
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Lace cursor at line (A) col 
CV and BASL,H from 



Set BASL , H from CV (and WNDLFT). 
Set BASL,H from (A) and WNDLFT 
without regard to CV. 

Set RASL,H to left end of screen 
line (not window line) in A-reg. 



Hex +Pec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 











A 












36 


$24 


WNDLFT 


32 


$2(3 


37 


$25 


WNDWDTH 


33 


$21 


38-39 


S26-27 


WNDTOP 


34 


$22 


40-41 
50 


$28-29 
S32 


WNDBTM 


35 


$23 





10 
11 
12 
14 

1000 

1010 
1100 
1199 

S 
w 

1229 

1230 
1235 
1300 

1399 
1400 

1500 



1511 
1519 
1520 



1601 
1700 
1720 
1740 
1800 




REM TfiXT OUTPUT WITHOUT THE SCROLL WINDOW 
REM SAMPLE PROGRAM 

REM READS FROM KEYBOARD LINE, CHAR, STRING 
REM AND PLACES THE STRING THERE 
REM PROGRAM ENTRY 

DIM L%(23): REK LINE ADDR TABLE 

GOSUB 63000: REM MAKE UP TABLE 

REM PRINT PART Of TABLE JUS 

FOR I - TO 21: PRINT 1,L%(I): NEXT 

REM DELAY TO ALLOW LOOK AT IT. 
FOR I - 1 TO 5000: NEXT 

PRINT CR TO ALLOW CTL-S STOP 
REM CLEAR SCREEN BEFORE CHAN 

REM SET UP NEW WINDOW . 

POKE 32,24: POKE 33,14: POKE 34,12: POKE 35,17 

CALL -936: REM PUT CURSOR INTO WINDOW AREA. 

INPUT LI,CL,SS$:REM READ A COMMAND LINE. 

A WAY OUT 

IF SS$ = "END" 
SL = LEN (SS$) 

REM CHECK LEGALITY 
IF LI > 23 THEN 1810 
IF CL > 39 THEN 1810 

REM NOT PAST 40 
IF CL + SL > 39 THEN SL = 40 - CL 

REM PUT CHARACTERS ONE 

FOR I = I TO SL 

C$ = MID$ (SS$,I,1):C% - ASC (C$) 
POKE LZ(LI) + CL + I - 1,C% + 128 
NEXT I 

GOTO 1300: REM GO BACK FOR ANOTHER COMMAND. 




t 



I - 
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H10 



REM LINE OR CH TOO BIG - 



PRINT "LN ";L1: PRINT "CH ";CL 



1 HI i CALL - 936: PRINT "NOT SO BIG" 
1820 

'V10I0 x% 



REM 

REM MAKE UP 
* PEEK (37); REM REMEMBER CV 
M020 FOR T = TO 23 

<)'i010 POKE 37,1: REM SET CV 

h 30:31 CALL -990: REM CALL VTAB TO FILL BASL & BASH 

L%(I) - 256 * ( PEEK (41)) + PEEK (40) 

Ii't040 NEXT I 

1.1045 REM TABLE SETUP DONE 

63046 

M0 r >0 POKE 

f.'l0f>0 RETURN 
f>39( 



in* 



SECONDARY DISPLAY AREAS 



Tin' Apple II hardware allows use of either of two memory areas for 
display to the screen. The first, or primary, is memory locations 
.$0400-$07FF. The secondary text (and low resolution graphics) display 
a,ve$ Is $0800-$0BFF. This area is normally overlaid by a user program 
or data, but in special circumstances a user may deaire to make use of 
I !i I s secondary area as a screen display area. 




mmm®, are descriptions of two ways of using the secondary display 
nr«M. 




Thrre are times when it is desirable 

quickly, although the program produce 
a program might display data found by 
programmer might generate the origina 
display area, then move it to the sec 
hardware to display from secondary. 
Kmernto the next screen data in the 
Is looking at the Initial or previous 



program is provided later in this sec 
routine can be used to t 
to iho secondary 



to change the display very 
s the output slowly. For exa 

scanning a disk file. The 
1 screen data in the primary 
ondary display area and set the 
The program may then proceed to 
primary area while the operator 

display of results. A sample 
tion showing how the Monitor Move 
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When the Monitor places a character in the screen memory area, it does 
so using BASL,H as the address of the memory location for the left end 
of the line, and (CH) as the displacement from the left end of the 
line. BASL,H can be initialized to the memory location of a selected 
screen line by setting the desired line number in CV and then CALLing 
TABV. On return from that CALL, adding 4 to BASH changes BASL,H to 



Jint to memory for the desired line in the sec* 

-is will last until the prosrsm writes a carriage return or writes 



characters beyond the right end of the Scroll Window. 

If the Monitor is called upon to read from the keyboard, it "echoes" 
the input characters to the screen. Input of a carriage return, one 
backspace too many, a cursor movement, or a screen clearing Escape 
Key function will cause BASL,H to be restored by the Monitor to point 
wiLhin the primary display area. 




In the case where one display area is to 
other for 

primary area and the text in the secondary are 
recomputes GBASL,H continually for plotting ft 
text output BASL , H is recomputed only when it 
cursor to a new line. 



ed for text am 

Lcs in 




It must be noted that APPLESOFT also does not (easily) support the 

secondary display area. APPLESOFT in RAM occupies that part of memory, 
and then some. Firmware APPLESOFT places the program code in that 

memory space, unless special actions are taken. Those actions may be 

ss APPLESOFT and the secondary 

i.-i, u 



noted in the sample program, whicl 
area. POKE If 



/ 




Function 




Place cursor at line 
(store A to CV and coir 
by JMP to VTAB. 

Set BASL , H from CV and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL.H from A-reg and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL,H to memory address for 
left character of screen (not 




V 



FC22 64546 -990 VTAB 
FC24 64548 -988 VTABZ 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Write byte in A-reg to screen at 
cursor (CV),(CH) using 1NVFLG and 
supporting cursor move. 

Write byte in A-reg to screen at 
(CV),(CH) with cursor move but 




routine. (AIL,H) thru (A2L,H) is 
moved to (A4L.H) thru whatever. 





Monitor Command Processor GO entry. FEB 6 
Set PCL,H from AlL.H if entered. & 

Call RESTORE, set all regs but S & FEB9 

.IMP via PCL,H, FEBC 











65206 -330 



65209 
65212 



-327 
-324 



~ 



mi 




— 



none 




DIRECT CONTROL ADDRESSES 



The following table describes the methods of setting the hardware 
display to various screen configurations by direct control rather 1 

by calling the Monitor. For some of these items there is no routine 
In the Monitor which could be called to perform the function. 

Function 



Sot CFAPHICS display node. 
Set TKXT display mode. 
S<>t Graphics mode to Full 
Set MIXED GRAPHICS and TEXT mode. 
Sot display to Primary Page. 
Set display to Secondary Page. 
Clear HIRES = Set LORES mode. 

Sot HIRES Graphics mode. 

Sot top line of Scroll Window. 

Set left edge of Scroll Window. 

Set width of Scroll Window. 

Sot bottom line of Scroll Window. 



POKE 


-16304,0 


or 


STA C050 


POKE 


-16303,0 


or 


STA C051 


POKE 


-16302,0 


or 


STA C052 


POKE 


-16301,0 


or 


STA C053 


POKE 


-16300,0 


or 


STA C054 


POKE 


-16299,0 


or 


STA C055 


POKE 


-16298,0 


or 


STA C056 


POKE 


-16297,0 


or 


STA C057 



POKE 34, line-number (0-23) 
Bottom must be greater than top. 
POKE 32, column-number (0-39) 

edge + width not to exceed 40. 
33,number-of-columns (1-40), 

Left edge + width not to exceed 40. 
POKE 35, line-number (1-24] 
Bottom must be greater than top. 



Gil 
CV 

CHASl.,11 
KASl.,11 



36 
37 

38-39 
40-4 1 







$24 


WNDLFT 


32 


$20 


$25 


WNDWDTH 


33 


$21 


$2 6-2 7 


WNDTOP 


34 


$22 


$28-29 


WN DB'i'M 


35 


$23 



10 REM SAMPLE SECONDARY DISPLAY WAY 

11 REM USING MONITOR MOVE TECHNIQUE 



19 COTO 1000: 



20 REM MOVE AREA 1 TO AREA 2 

21 POKE 60,0: POKE 61, A: REM SET AlL.H 

22 POKE 62,255: POKE 63,7: REM SET A2L ( H 

23 POKE 66,0: TOKE 67,8: REM SET A4L,H 

25 POKE 71,0: REM SET Y-l 

26 POKE 58,44: 

27 POKE 59,254: 

28 CALL -3 

29 RETt 




;■: ■ 



1(300 REM PROGRAM START 

1001 IF PEEK (75)<12 THEN 32000 



1100 CALL -936: 



REM CLEAR THE SCREEN 



1200 PRINT "THIS IS THE SECONDARY DISPLAY 
1210 PRINT "NOTE THE LACK CF CURSOR" 



■ 



13 





SET SECONDARY 



IS THE 

1500 POKE -16299,0: 
1600 FOR 1=1 TO 4000: NEXT I 
1700 POKE -16300,0: REM BACK TO PRIMARY 

1800 END 



32000 

32001 PRINT "P 

32002 PRINT " 

32003 END 



REM NO LOMEM ERROR 




APPLESOFT SAMPLE PROGRAM 



13 
14 



REM SAMPLE PROGRAM 
REM READS FROM KEYBOARD 
REM COMMAND, LINE, CHARACTER, STRING 
REM AND PLACES THE 



1000 



REM PROGRAM ENTRY 



1009 

1010 IF 



REM IS SECONDARY AREA CLEAR? 
PEEK (104) < 12 THEN 62000 



I 300 
1309 
1310 
I Hi 



190 
00 



I A 
1410 
14^0 
1430 
1431 

I 4 14 
I 4 >0 



1511 

1512 
1590 
U»00 
1610 

I 1,20 
1 /00 

1710 

1 800 
1 H10 
181 I 
I 812 

1 Wt 



REM MAIN 
IF Q = THEN 1390: 

POKE 37,21:^ 



PROGRAM 
TO 




INPUT CC$,LI,CL,SS$ 

IF CC$ 1 



IF CC$ 
IF CC$ 



"END" THEN 63900 
"S" THEN 2000 



IF 
IF 



CC$ 



up.. 

"Q" 



IF CC$ 



THEN 2100 
THEN 2200 
"R M THEN 2300 
"X" THEN 1500: 



REM SET SHOW TO SECONDARY AREA 

REM SET SHOW TO PRIMARY 

REM SET INPUT SECONDARY 

REM SET INPUT PRIMARY 



POKE 16300,0: PRINT » 
SI = LEN (SS$) 

IF LI > 23 THEN 1810 

IF CL > 39 THEN 1810 

IF CL + SL > 39 THEN f,L 

CX = PEEK (37): 

POKE 37, LI: CALL - 990: 

POKE 37, CX: 

POKE 36, CL: 

SP$ = LEFT$ (SS$,SL): 
PRINT SP$ 

GOTO 1300 
CALL - 936: 

PRINT "NOT SO . 
PRINT "LN ";LI: 
GOTO 1300 



": GOTO 




= 40 - CL: REM NO 
REM REMEMBER CV 
POKE 41, PEEK (41) + 4 
REM RESTORE CV 
REM SET CH FOR THIS PRINT 
REM SHORTEN PRINT IN THIS SMPL 



REM VALUE TOO LARGE. 
EK PRINT IN PRIMARY ONL^ 




POKE - 16299,0: 
GOTO 1300 

POKE - 16300,0: 
GOTO 1300 

Q ■ 1: GOTO 1300: 



■ 



REM SET PRIMARY 



REM SET INPUT TO SECONDARY 



62010 
62018 
62019 
62020 

63000 
63 Wl 
63005 
63010 

63020 
63030 
63040 

63050 
63060 
63070 



PRINT "SETUP NOT MADE, NOW BEING DONE" 
PRINT "RUN THE PROGRAM AGAIN" 

REM 104 IS APPLESOFT ROM S' 
RKM BYTE BEFORE $C01 MUST 
POKE 3072,0: POKE 104,12: END 




_ it 



BL$ = 

FOR I = 1 TO 3:BL$ 

CX = PEEK (37) 
FOR 1=0 TO 23 

POKE 37,1: CALL - 
POKE 41, PEEK (41) + 4 
POKE 36,0 
PRINT BLS 
NEXT 

POKE 37,CX: POKE 36,0 




AREA 




INTERRUPT PROCESSING 



So 



mo computers are capable of reacting to the raising (or dropping) of 

;i signal line by instantly saving the current status of the processor, 

jind quickly transferring control to some other program within jthe 
computer. Chang?ng the state of that line is called "causing an 
Interrupt". The functions of the processor in saving its current state 
find transferring control to some other location In memory is called 
"taking an interrupt' 1 . The program which then receives control is 
4-xpected to "handle the interrupt". 



6502 microprocessor in the Apple II is sensitive to three 




m he simulated 




Tin* purpose of an interrupt, in general, is to allow some kind of 
I'xLernal device to make a condition known to a running program without 
(lit* program having to periodically or continually test for the 

hardware condition. An example of the latter type of operation is the 
Apple II keyboard operation. When keyboard input is to be accepted 

iru'L-inry location $C000 is tested repeatedly until presence of the sj 

hit indicates that a key has been pressed. An example of inti 
driven processing could be a special peripheral controller card, 
ii ( l .'loll ed to a telephone line, which caused the computer to be 
over by a data acquisition program any time data was available, 1 
would allow the machine to be used for other things in between 




When a < 



thre« 



an 



jcessor status in such 
interrupted program can be continued after the 

been "serviced" or handled. 




2. Prevent further rec 

the interrupt han._ 




Transfer control to the pr< 
category of interrupt. 

Uh the 6502 In the Apple II variations on the above three steps are 
l.iki-n for the three different interrupt classes or categories. 

1. When an IRQ (or BRK) or NMI interrupt is taken, the contents of 
the program counter and the P~reg (processor status register) 
are respectively pushed onto the stack. When a RESET interrupt 
Is tnken, the processor holds the memory in REAfl mode until 
control Is transferred to the handler, so nothing of processor 
status is pushed onto the 




2. When the 6502 takes an IRQ interrupt, the P-reg is modified. If 
a BRK instruction is executed, the $10 bit of the processor 
status register is set to one before the P-reg is pushed onto 
the stack. If the IRQ line was the cause of the interrupt, this 
bit is set to zero before the P-reg is pushed onto the stack. 

After the P-reg is pushed onto the stack, the $04 bit is set to 
inhibit recognition of any more IRQ category interrupts until 
the interrupt handling program clears this condition. 

With RESET and NMI there is no available facility for 
preventing another interrupt while the current interrupt is 
being handled. 

% The 6502 transfers control to the appropriate program for 

handling an interrupt by means of "vectors". Memory addresses 
$FFFA-$FFFF are reserved for this purpose. The final step of 
taking an interrupt is loading of the program counter from the 

two Monitors* 



Interrupt Vector 

Address 



Monitor Old Monitor Autostart 
Label Address Address 




$?FFA-B 




"NMI" 
SET 





$03FB 





e II Monitor does not interfere with user handling of 
rrupt. That is, the vector for NMI causes the 6502 

S, where 




to t 

the user is 
this type of interrupt 



RESET INTERRUPT SUPPORT 



ng the RESET key on the keyboard causes a RESET interrupt 
to occur. On all Apple II 's but the very early ones, power-on 
also results in generation of a RESET interrupt. 



The actions performed by the Autostart Monitor and the Old 
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When either an 

executed, 

of the 
of the 



4 T 



interrupt is t 
an i 





instruction is 
The coi 
• — 510 Mt 




cate th 
onto the st, 

then sets the $04 bit of the P-reg, preventing another 
interrupt of this type from being recognized until this one is 
handled. The 6502 then loads the Program Counter from the IRQ 
hardware prescribed vector at $FFFE-$FFFF, and allows operation 
of the computer to continue from that point. The I 
Handler for IRQ interrupts is now in control. 



RESET INTERRUPT— OLD MONITOR 



When a RESET intei 
predefined cotlf f - 
the keyboard is 



the Old Monitor establishes a 
ition of hardware and page zero fields. Primarily, 

input device, the screen is set as 

is set to full 




I'hrc zero fields KSWL,!!, CSWL,H are set to make the keyboard and 
Mcreen active. WNDLFT, WNDWDTH, WNDTOP, WNDBTM are set to define the 
whole screen as the Scroll Window. CV and CH are set to place the 
-urHor at the bottom left corner of the screen. INVFLG is t 



Hardware 
an 



8 



■ • 



$C056 - clear high resolution gr<3 

" display primary area 
M0i - set text mode 



Cfnii rol ia then transferred to the "top" of the Monitor at label MON, 
location $FF65, at which point the "bell" is sounded and the Monitor 

niters the command line read routine. 
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Hex +Dec -Dec Monitor Reg 1st era 
Addr Addr Addr Label Destroyed 



Set STATUS in SAVE area to 0. & FB2F 

Clear HIRES. & FB33 

Set primary display area. & FR36 

Set TEXT mode. & FB39 
Set full screen scroll window by KB3C 

branch to SETWND with (A)=0. 

Set WNDTOP from A-reg. & FBAB 

Load A with for WNDLFT. & FB4D 

Set WNDLFT from A-reg. £. FB4F 

Load A with 40 tor WNDWDTK. & FB51 

Set WNDWDTH from A-reg. & 

Load A with 24 for WNDBTM - & 
Set WNDBTM from A-reg- & 

Load A with 23 for CV. & 

Set CV from A-reg. & 
JMP to VTAB to set BASL,H f, RTS. 
Set INVFLG to $FF = normal video. 

Set INVFLG from Y-reg. 
Set port (keyboard) for input. 

Set port 9 (screen) for output. 



Fl 

FB57 

FB59 

FB5B 
FR5D 
FE84 

FES 6 
FE89 

FE93 



Monitor entry on RESET key pressed 
or Power on. 

Call SETNORM - white on black. & 
Call INIT -Text & full scroll. & 

Call SETVID - screen as output. & 

Call SETKBD - keyboard = input. & 
Clear 6502 decimal mode (set hex) & 

Sound bell. & 
Monitor Command Processor Entry. 
Set "*" as prompt character. 



FF59 



FF5C 
FF5F 

FF62 
FF65 

FF66 
FF69 



64303 


-1233 


INIT 


A 


64307 


-1229 




A 




"1226 




A 


OH Jl J 


"1 115 


SE iTXT 


A 


OH J 1 U 


— 1 




A 
A 


a ft ) 


i ort ^ 
— 1 


bEjlWND 


A 

A 


64333 


-1 203 




I 


64335 


-1201 




1 


64337 
64339 


linn 

-1 199 
-1197 








-1195 






64343 


-1 193 




1 


64345 


1 1/11 

-1 1 VI 




A 


64347 


-1189 


TABV 


A 




— 1 1 Q7 

I lo/ 




A 


OO 1 JO 






V 

X 






!>hl ir Hi 


none 


AS 1 fy 1 






A V Y 


o!>l / I 




OB 1 V1U 


A V V 

A,X,Y 


65369 


-1 67 


KESET 




65372 


-164 






65375 


-161 






65378 


-158 






65381 


-155 


HON 




65382 


-154 






65385 


-151 


MONZ 

■■ ■ 








MONITOR 



The Autostart Monitor performs 
handling a RESET interrupt. 

1* Establish a known hardwar 
Che basic machine. 



s 



If the contents of memory (page three) do not Indicate that a 

power-on initialization has been performed, the Autostart 

Monitor will perform power-on initialization. If a disk 
controller card is present In one of the slots, power-on 

initialization includes bootstrapping from that slot. Tf no 
simulated. Tn either case, the appropriate language nrocesso 



receives control at the end of power-on initialization, with 
page three fields set to indicate that a warm start is to be 



3. If the contents of meraory (page three) indicate that power-on 
initialization has already been performed, the Autostart 

Monftor will transfer control via the RESET (Soft Entry) vector 

in page three at the conclusion of "handling" the RESET 
interrupt. Tf DOS has been booted, this will result in transfer 

of control back to the current language processor through DOS. 
If DOS is not present, the normal setting of the RESET vector 
will cause simulation of a co 

C he current language* 



INITIALIZE SYSTEM CONFIGURATION 

When a RESET interrupt is taken, the Autostart Monitor establishes a 

(•redefined configuration of hardware and page zero fields. Primarily, 

i he keyboard Is set as the current input device, the screen is set as 
Hu> current output device, and the screen configuration is set to full 

HV-Pmn Scroll Window with normal video. 

zero fields KSWL,H, CSWL,H are set to make the keyboard and 

iicn-on active. WNDLFT, WNDWDTH, WNDTOP, WNDBTM are set to define the 
whole Hcreen as the Scroll Window. CV and CH are set to place the 
rursor at the bottom left corner of the screen. INVFLG is set to 
normal (white on black). 

Hardware' addresses are referenced to establish a known configuration 
Jill 1 n 1 t <>W. 

',;Ctf'i<> - clear high resolution graphics 
':;i:0V. - display primary area 

PpfJ " ftet text mode 
0S$ft - clear AN0 = TTL LO 
Sftfc*^ - Hear ANl » TTL LO 

$0M - set AN 2 = TTL HI 
$<:0'>F - set AN 3 - TTL Til 

?C.KK|'' - turn off Expansion ROM 
\jt - rlear keyboard strobe 

i)n com pi i'i Ion of all the above, the Autostart Monitor sounds the BELL. 



COLD/WARM DETERMINATION 



Alii'i nil abl I nil 1 ng a known basic hardware and software (screen 

I'MoMirhi) iuiv i r o nraen tc, the Autostart Monitor executes a test to 
ih'l i* mi I in- wlu'iln'r power— on initialization Is to be performed. 
iktiw Uimt-hm ^3I'2-$03F3 contain the RESET (Soft Entry) vedui, i 
• uldr.'.'ut in which the Autostart Monitor will transfer control on 
roinpl.-Hon ol handling the RESET interrupt. Location $03K4 is a 




validation byte, used with S03F3 to indicate whether or not power-on 
initialization is to be performed. If the Exclusive OR of the contents 
M these two memory locations is $A5, the* P ower-on initial^atlon U 
considered to have been previously accomplished, and $03F2-$03F3 is 
considered a valid address to which to transfer control- 



POWER-ON INITIALIZATION 



first functions of power-on initialization are to establish In 
page three ($03F0-$03F4) the BRK interrupt vector (see "BRK 
Instruction Handling - Autostart Monitor") and che RESET Soft Entry 
interrupt vector with validation byte. The RESET vector at this point 

is set to $E000 to 




Th< 



Autostart Monitor next performs 



frorc slot 7 through slot 1, for presence of a disk controller card. 



a routine which tests each slot, 
a 

If one is found, a jump Is performed to $CX00 where X is the slot 

number in which the disk controller has been foimd. This will result 
in loading of DOS and presumably execution of the HELLO program* 

Note: DOS 3.2 Replaces the RESET vector at $03F2-$03F3 and validation 

byte at $03F4, so that on a RESET interrupt, control will be passed 
through DOS back to the current language processor* 



If no disk controller card is found the Autostart Monitor changes the 
RESET vector to $E003 (language restart or eontrol-C entry point) and 



SYSTEM RESTART 

If the $03F3-$03F4 test described above is passed, the RESET vector at 

$03F2-$03F3 is considered mostly valid. If it contains $£000, it is 

chanced to $E003 and then BASIC is entered at $E000. If it is not 
$EW9, it executes an Indirect Junp via $03F2-$03F3 to the — - 

tl 




. 




The RESET vector may be modified by user or program to send control 
some other address in the siachinc at the completion of Monitor 
handling of the interrupt. For example, to cause the RESET key to 
Hilt in placing the machine in Monitor mode, execute the follow! n : 



to 



10 POKE 1010,105 
20 POKE 1011,255 
30 POKE. 1012,90 
40 CALL -151: 





The following program is more general purpose. In order to set the 
RESET vector to some address, poke the address into locations 1010- 
1011 ($03F2-$03F3) and then CALL Autostart Monitor label SI 
<$FU6F or 64367 or -1169) to set location 1012 ($03F4). 

10 RKH AD IS ADDRESS OF 
H REM ROUTINE TO RECEIVE 

l| REM CONTROL AFTER RESET 
V'0 POKE 10 10, AD: REM SET LO BYTE 
10 I'OKK 1011, AD/256: REM SET HI 



1 



Not r: If you try to run this on a system with an Old Monitor ROM, you 
ra/iy destroy the program, or even the entire diskette. To avoid this 
problem, execute the Steps in the above program manually, 
with an Autostart ROM. Then, PEEK location 1012 and eet 



I'OKK into 1012, 



on a system 
location 1012 and get the value to 



9 at all. 




Fnnrl Ion 



Addr 




Moii 1 1 or entry or; 
or Power on. 

CM) - clear 6502 dec, (set hex). & 

flail .S KTNORM - white on black. & 

gfiitvi I W IT - Text, full scroll. & 

C.i II SETVID - screen as output. & 

CjjII RI'TKBD - keyboard as input £ 

ln.'l hilfze hardware to known state. 

i:i<vir AN0 to TTL LO (ref. C058). & 

clour AN 1 to TTL LO. (ref. C05A). & 

Sol AN 2 to TTL HI (ref. C05D). & 

Sof AM 3 to TTL III (ref. C05F). & 

L'loar Expansion ROM (ref. CFFF). & 
I! I i*«i r koybo 



-.Oec Monitor Registers 
Addr Label Destroyed 





FA63 
FA66 
FA69 
FA6C 

FA6F 

FA72 
KA75 
FA76 1 
FA7B 
FA7E 
FA81 



64099 

64102 
64103 
64108 
11 1 



■1437 
•1434 
-1431 
-1428 

-1425 





-1393 



t:\tutr d r >02 
Call HKIX. 

Tost $m vs. 03F4: Cold or Warm 
I 1 Col (I goto PWRUP. 
H (-S3F-3) XOR (S3F4) = $A5, Warm 

Tom! SoKTKV ($3P7.) low byte: 
n-hi-/.ito means Cold Start done - 

Col.. NOKiX to use SOFTRV vector 

y.oro iiioiiiiH restart warm naybc. 
Tout SOKTEV hi for $E0 - language 

rolil nt/irt ontry. If nor equal, 

liOKTKV 1h ok to use, goto NOFIX. 
SOI'TEV - !>K000, change to $E003 for FA9B 64155 -1381 FJXSEV 

loif.ro oko and goto $E000 to cold 

»iuri Iho Uutguagi!. 



FA94 64148 -1388 



Hex 
Addr 



+T)ec 
Addr 



-Dec 
Addr 



Monitor Registers 
Label Destroyed 





;e the Soft Entry 
^vector to exi t^RE SET handler.^ 

Call APPLEII to clear screen and 

put title on top line. & 
Set page 3 Interrupt vectors for 
BRK (OLDBRK) and SOFTEV ($EUW). 
Look for disk controller card in 
slots 7 thru 1. If none, goto 
FIXSEV above to set SOFTEV for 
BASIC restart & enter BASIC o 
If disk found, JHP (LOCfl) 
the disk* 
r screen (call HOME). & 
Place APPLE II legend on top line. 
Set PWREDUP ($3F4) = (S3F3) XOR $A5 

Set STATUS in SAVE area to 
Clear HIRES. 

Set primary display area. 

Set TEXT mode. 
Set full screen scroll window by 

branch to SETWND with (A)=0. 

Set WNDTOP F rom A-reg. & 
Load A with for WNDLFT. & 

Set WNDLFT from A-reg. & 

Load A with 40 for WNDVDTU. & 
Set WNDWDTH from A-reg. & 

A. with 24 for WNDBTM. I 

; WNDBTH from A-reg. & 

Load A with 23 for CV. & 

Set CV from A-reg. & 

Jump to VTAB to set BASL , H & RTS. 
Set INVFLG to $FF * normal video. 

Set INVFLG from Y-reg. 

Set port (keyboard) for input. 

Set port (screen) for output. 




A9 64169 -1367 SETPG3 



FB60 
FB63 
FB6F 



- 




FB39 
FB3C 



FB4B 
FB4D 

FB4F 

FB51 
FB53 

FB55 
FB57 
FB59 
FB5B 

FB5D 



FE89 

mm 



64352 
64355 
64367 




64316 



64331 
64333 

64335 

64337 
64339 

64341 

64343 
64345 
64347 

64349 



-1184 
-1181 
-1169 

-1229 



APPLEII A,Y 
A,Y 
SETPWRC A 
A 



A 




SETWND 





A 
A 
A 

A 
A 

A 

A 

A 
Y 




a!x,y 



FOR COMPATIBILITY WITH OLD MONITOR FF59 65369 -167 
:T routine is still here. 

- white on black. & 

li! iia^^ii^ ! gl gf 5 --lot 

- keyboard = input, i FF62 65378 -158 

r 6502 decimal mode, set hex. & FF65 65381 -155 

bell. & FF66 65382 -154 

[tor Command Processor Entry. FF69 65385 -151 

as p 



OLDEST 





IRQ/BRK INTERRUPTS 



IRQ/BRK INTERRUPT RECOGNITION 



When either an IRQ interrupt is taken or a BRK instruction is executed 

I he 6502 performs an interrupt sequence. The contents of the program 

counter are pushed onto the stack. The $10 bit of the P-reg is set or 
cleared in Indication of IRQ line vs. BRK instruction, and then It is 
pushed onto the stack. The 6502 then sets the $04 bit of P-reg, 
preventing another interrupt of this type from being recognized until 
this one is handled. The 6502 then loads the Program Counter from the 

IM hardware prescribed vector at $FFFE-$FFFF, and allows operation of 

t,V computer to continue from that point. The Interrupt Handler for 
IRQ Interrupts is now in control. 



IRQ INTERRUPT HANDLING 

'Hie 6502 directing vector at $FFFE-$FFFF points to Monitor program 
I vthol tRQ in both the Old Monitor and the Autostart Monitor. It will 
\fp noted in the address cable that the address is different, however. 

The handling of an IRQ Interrupt is identical in both Monitors. The 
I'oiitonts of the A-reg are stored at ACC ($45) for future reference. 

The processor status (P-reg) pushed onto the stack by the taking of 
(he interrupt is popped into the A-reg, and then pushed back onto the 

H&ai&K so that the stack and pointer are not changed. By shifting the 

A-reg left three bits, the IRQ routine moves into the sign bit the bit 

which Indicates (in this case by being a zero) that the interrupt is 

;in IRQ interrupt rather than execution of a BRK instruction. The 

Dim I lor then executes a Jump Indirect instruction via location $03FE- 
?0 IKK to the user provided IRQ Interrupt Handler. Note that on an IRQ 

Interrupt the X, Y, and S registers are not saved by the Monitor. 

Al «o, the interrupt handler has the re; 
Ml on exit to allow further interrupts. 




BRK INSTRUCTION INTERRUPT 

Kxrcut 1 on of a BRK instruction causes the 6502 to simulate an IRQ 
I .-if crrupl with minor changes. Due to the method the instruction is 

imam* m address pushed onto the stack as part of the interrupt 
n 1 urn I nl Ion is two bytes beyond the BRK instruction executed. 

th-lorc pushing the P— reg onto the stack, the $10 bit is set to 

In tjlc /i to to Lhe interrupt handling routine that the cause of the 
Interrupt w;ih execution of a BRK instruction rather than the IRQ line. 

AM fi pushing the P-reg onto the stack, the $04 bit is set to inhibit 

I HQ I of rrnipt s from being recognized until the interrupt handler 

t I i-jivfi I h<* eoiulf t Ion. Control is then transferred according to the 

fi'«0i' IRQ Interrupt vector to Monitor label IRQ. As described above 

t'i'KJirdI in* handling of an IRQ interrupt, the IRQ routine first stores 
)h*' A-r«y. "I ACC ($45) for future reference, and then uses the A-reg 
Id ti-Hi the stacked P-reg contents for a one in the $10 position. The 
Him k mid «iiick pointer are not changed by this operation. The result 

NTERRUPT I 



of the test, is a transfer of control to Monitor label BREAK. Note In 
the address table that the address of BREAK is not the same in the two 
Monitors. 



BRK INSTRUCTION-SAVING OF STATUS 

In each Monitor the first thing done in the BREAK routine is to save 

full machine status in page zero. The contents of the A-reg have 
already been stored by entry into the IRQ interrupt handler. The BREAK 
routine pops the stacked contents of the P-reg from the stack, and 

does a JSR to SAV1 at which point the remaining registers are saved. 
Note that this clears the $0^ bit, allowing further IRQ or BRK 
Interrupts to he taken. The S-reg saved at that time, however, has 
been incremented once by popping the P-reg back from the stack and 
decremented twice by the JSR to SAV1. On return from SAV1, the BREAK 
routine pops the Program Counter from the stack and stores it in page 
zero locations PCL-PCH. The address table at the end of this section 
indicates the page zero locations at which the above items are stored. 



BRK INSTRUCTION-OLD MONITOR 



The function of the BRK instruction interrupt handler of the Old 
Monitor is to display through COUT the machine status at the time the 
BRK instruction was encountered, and then return control to the top of 
the Monitor at label MON. The details above describe the handling of 
the interrupt through storage of machine status in page zero, 
including PCL,11. The Old Monitor BREAK routine next does a JSR to 
INSDS1 to display the instruction at the address indicated by PCL-PCH 
(which Is two bytes beyond the BRK executed), and a JSR to RCDSP1 to 
display the contents of the five registers, P, A, X, Y, S. Note that 
the S-reg as displayed is two less than it was at the time of the BRK 

On completion of the register 



interrupt. 




BRK INSTRUCTION— 




The Autostart Monitor handles IRQ interrupt which is really a BI 
instruction interrupt by saving registers and Program Counter in page 
zero locations. The Autostart ffonitor BREAK routine then exits via the 
Apple-II BREAK vector at $03F0-$03F1. Thus, it is possible for a user 
program to gain control at that point and do something other than to 
display the registers and return to the Monlt or command processor. 
Such a program must be sure to clear the $04 bit in the P-reg on 
return. During RESET interrupt handling for power-on, this vector is 
initialized to point at Autostart Monitor label OLDBRK, which routine 
does the same thing as was done in Old Monitor. That is, it does a JSR 
to INSDSl to display the disassembled instruction at the location 
indicated by PCL- PCH, a JSR to RCDSPl to display the register 
contents, and a JMP to MON to complete the handling of the i 



Note: after DOS 3.2 has destroyed page 3 during the bootstrap 
operation. It restores this vector to point to r 



■ TABLE 



Hex 
Addr 



+Dec 
Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



Disassemble the instruction at 
(PCL, II), print thru COUT. 

Display registers thru COUT from PAD 7 
save area, after carriage return. 

Display registers thru COUT from FADA 
save area. 

Save 6502 regs at §45-49. FF4A 

Save A-reg at ACC $45. & 

Save X-reg at XRKC §46. & 

Save Y-reg at YREG $4 7. & _ . _ 

Save P-reg at STATUS $48, & FF50 

Save S-reg at SPNT $49. & FF54 

Clear 6502 decimal mode (set hex). 
Clear 6502 decimal mode (set hex) & FF65 

Sound bell. & FF66 

Monitor Command Processor Entry. FF69 
Set ,? * n as prompt character. 

AUTOSTART IRQ/RRK flANDLING 

Determine whether interrupt was 

IRQ or BRK, transfer control 
accordingly. 

Handle BRK interrupt: 

Restore P-reg from stack. 
Save registers (SAVl) X,Y,P,S. 
Move interrupt location from st 

to PCL,H. 
JMP (ERKV) to possibly user 

specified routine (normally to 

OLDBRK, below). 
Default BRK interrupt handler KA^y 
completion routine 

Display instruction (2 bytes past), 



1840 INSTDSP A,X,Y 



64215 -1321 REGDSP 



— 1 , 



-1 




— 
-1 




_ 



-172 

65381 -155 MON 

65382 -154 
65385 -151 MONZ 



-1 u 



i 



A,X 



64218 -1318 RCDSPl A,X 




control 



Determine 

IRQ or BRK, ' 

accordingly. 
Handle BRK Interrupt: 

Save registers, 

Display instruction (2 bytes past), 

Display registers, JMP to MON. 


PCL.H 58,59 $3A,3B 
ACC m $45 



FA92 



***** 







YREG 



71 



$47 




1 



► 

fc 
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CHAPTER 4 








Tli.Tt' are ma:vy routines in the Monitor which can be helpful when 

developing machine language programs. Some of these are routines 
lined in the finished program, like the Monitor MOVE i 



In this list are general, special, or very special screen 
routines, and some data manipulation routines. 




Function 



WrUi! byte in A to screen at CV,CH. 
Print carriage return thru COUT. 
Print three blanks thru COUT. 
Print (X) blanks thru COUT. 
Print character 

<X)-I blanks. 
I'r Int BELL code 
Print 



FDKO 
FD8E 
F948 



c 



or Registers 
Destroyed 



65005 
64910 
63816 




•531 COUT 
■626 GROUT 
•1720 PRHLNK 



t;2 



?A 

A 

A,X 



A,X 



A 




Print \m 

Print A-reg as 

Print hex of Y,X regs. 

Print hex of A ( X regs. 

Print hex of X-reg. 

Print OR, then hex of Y,X regs, 

L I tan minus sign (or dash). 

Print hex of Y,X regs, then dash. 

Print m* hex of A1H.A1L, and dash. 

Print memory as hex with preceedi 
.'iildress from nuantm tc mmm7 where 

mmm ts initial content of 
Print memory as hex from (AIL, 
l hru (A2L.H). 



F940 
F941 
F944 
FI)96 

FD99 




■ 

V I 




63808 
63809 
63812 
64918 

64921 
1 



fTE 

-1728 PRNTYX 
-1727 PRNTAX 
-1724 PRNTX 
-618 PRYX2 

-615 



A 
A 
A 
A 
A 

A,Y 

II - 

* -_ 

A V 




r;..vi- A,X,Y,P,S regs at $45-49. 

display registers with names from 
<;;4W>9 m SAVE*, with preceeding 

i-iirr iny\v return. 

ftl"KpT;rt| regs m above without OR. 
Krst.oro regs A,X,Y,P not $ from m 



FF4A 65354 -182 SAVE 

-1321 



i 



-13 
-1 



■ 




Monitor Command Processor GO entry. FEB6 

Set PCL.II from AIL, II if entered. & 
<:.ill li KSTOKK , set all regs but S.S FEB9 

.lump via PCL.,11. 
IIovi' memory contents to (A4L,H) 
I rom (AIL, II) thru ( A2L,H) • 



65206 
65209 



•330 GO 
-327 




A 
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Compare memory contents (A4L,H) 

co (A1L,H) thru (A2L,IT), print 

differences thru COUT. 

Increment A4L,H ($42-43). & FCB4 

Increment A1L,H ($3C-3D), set Carry FCBA 
if A2L.H less than A1L,H« 

Set GBASL , H for line (A). F847 

Clear A-reg to a nibble , leaving F879 

in low nibble entry low nibble if 

entry carry clear, high nibble if 

entry carry set. 

iemble the instruction at 
u , H) , print thru COUT. 

Conpute (PCL.H) + (LENGTH) , leave 

results in A,Y. Decimal Mode Flag 

must be clear before calling PCADJ. 

Read paddle (X) Into (Y-reg). FB IF. 

Wait .01 seconds, then sound bell. FBDD 

Load Y=192 for .1 sec of bell. & FBE2 

Toggle speaker at 1 KHZ for number FBE4 

of cycles in Y-reg. 

Place character in screen refresh 

memory if not control character. 

If known control character, do it. 

If unknown control character, RTS. 



Hex +Dec 

Addr Addr 




-Dec Monitor Registers 
Addr Label Destroyed 



to top left corner. 
Load into Y, then print dash. FD9C 

Print dash thru COUT. FD9E 
Character print to screen output FDF0 

routine entry - normal for CSWL. 
Print character to screen with 
appropriate actions on controls 
control characters, 
f (A)<$A0 goto COUTZ, bypass 
inverse video masX. 
Monitor entry on RESET key pressed FF59 
or Power on. 

Call SETNORM - white on black. & 
Clear 6502 decimal mode (set hex).& FF65 
Sound bell & FF66 

Monitor Command Processor Entry. FF69 
Set "*" as prompt character & 
Set (a) as pronpt character & 
Monitor Command Processor command 
parsing routine; save hex digits 
in A2L,H, return with command 
(first non-hex) in A-reg, Y-reg 
set for next character. 

aTl,H 60,61 $3C,3D 
A2L,H 62,63 $3E,3F 
A3L.H 64,65 $40,41 



FF6B 







64692 
64698 

63559 
63609 



■844 KXTA4 
-838 NXTA1 



A 
A 



1977 GBASCALC A 
1927 SCRN2 A 




-1840 

-1709 PCADJ A,X,Y 



64286 
64477 
64482 
64484 



■1250 PRE AD 

1059 
1054 

■1052 BELL2 



64924 

64926 
65008 



-612 
-610 

-528 C0UT1 



65381 
65382 
65385 




-1 55 HON 
-154 

-151 MONZ 
-149 



A4L,I! 66,67 $42,43 
PCL,H 58,59 $3A,3B 

ACC 69 S45 
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A,Y 
A,Y 
A,Y 
A,Y 



FBFD 64509 -1027 VIDOUT A, Y 



?A 
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LORES PLOTTING 



In standard (or lew resolution) plotting mode, the graphic area of the 
ru'rt'pn is 40 points wide and either 40 points high with 4 lines of 

r<'Xt below or 48 lines high. The X coordinate is horizontal and the Y 
nmrdinate is vertical- The same memory area is used for low 

resolution plotting as is used for text output to the screen. However, 

In the graphics mode, each character position contains information for 

two plot points, one immediately above the other. Thus, 20 text lines 

: 0& used to display 40 graphics lines in the mixed mode, and 24 text 

I Ines are used to display 48 graphics lines in the full screen mode. 

There are four bits allocated for each point, by means of which the 
|.otnt may be displayed in any of 16 colors. 

The Monitor contains routines supporting the following functions: 
Set display mode to nixed graphics and text. 

Clear the graphics part of the screen (in whole or in limited 
part). 

Set a color control byte to be used for each plot point 
established until another color is selected. 

Plot a single point at an indicated vertical /horizontal position. 

Plot a horizontal line from one vertical/horizontal point to a 
vertical value. 

Plot a vertical line from one vertical/horizontal point to a 
vortical value. 

Keturn to requesting program the color value of the point at a 
specified coordinate. 

'IIhtc are limitations on some of these functions which may not always 
In- desirable. For example, using the entry point which sets mixed 
I'iMplitcs and text includes clearing the graphics part of the screen, 
netting the Scroll Window to be the entire remainder of the screen, 
mid moving the cursor (straight down from current position) to the 
bollom line of the screen. In addition, there is no Monitor entry 
point For wetting full screen graphics mode. However, the display mode 
.-ontrols are oasily set in any desired fashion merely by poking or 
Morlni- into the appropriate memory locations, so this is certainly no 
mix (or problem. 



Dec Hex 
Routine Addr. Addr. Description 



44 



S2C 



is set by the GBASCALC routine to the memory 
address of the plotting line specified. 



contains the selected color 
nd low nibbles of the byte. 



Lue in both 



is used internally by the plot routines as SF0 
or $0F to set either the high or low nibble of 
the receiving byte depending on whether the 
graphics line is the top or bottom of the two 
displayed from that "text" line. 

is the right end point for horizontal line 
drawing. 

is the bottom end point for vertical line 




Plot a point at line (A) col. (Y) 
leaving CBASL , H and MASK set- 

Plot a point, line per GBASL,H 
and MASK, col. in Y. 



(A) from 
right, 
line 

MASK from 



Draw horizontal line at 
(Y) thru (H2), left to 

Draw horizontal line at 
indicated by GBASL,H. 

(Y) thru (H2). 
Plot vertical line at (Y) from 
(A) thru (V2). 

Plot vertical line at (Y) from 

(AHl+carry thru (V2). 
Plot vertical line at (Y) from 

(A)+l thru (V2). 
Clear full (48 lines) screen. 
Clear graphics area (40 lines). 
Clear graphics partial from lint 

thru (Y). 40 col. wide. 
Clear graphics partial fr«n line 

to (V2) i0 col. wide. 
Clear graphics partial, Cop left 

lines thru (V2),col. thru (Y) . 



rs 

Addr Addr Addr Label Destroyed 



63488 -2048 
F80E 63502 -2034 



F819 63513 -2023 



F832 
F836 
F838 



PLOT 
PL0T1 

HL1NE 

■ T 



F828 63528 -2008 VLINR 



63538 
63542 
63544 



-1998 
-1994 
-1992 



CU-ISCR 
CLRTOP 
CLRSC2 



3 546 -19 



A 



A 



A,Y 



A 



F826 63526 -2010 VL INEZ A 



A,Y 
A,Y 
A,Y 



A,Y 
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Set T.ORES screen to COLOR 

left corner to (Y),(V2). 
Kntry A-reg must be C*. 

Kntry Y-reg = right column ro 

Set V2 to last line to set. 
Set COLOR for following points 
K. (A). 

Cluinge COLOR to (C0L0R)+3. 

m Color Graphics display mode 

and Following are also done; 
Set graphics mode; to Mixed. 

Clear graphics part of screen. 
Load $14 to A for WNDTOP. 

Si on- A to WNDTOP. 

Unit} to A for WNDLFT. 
Sr on- A to WKDLFT. 

I.<w.d $28 to A for WNDVDTH. 

Store A to WNDWDTH. 

Load $18 to A for WNDBTM . 

Store A to WNDBTH. 

Load $17 to A for CV. 
<■<> to TABV to set BASL.H. 



Hex 
Addr 



+Dec 
Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



— 



F864 63588 -1948 SETCOL 



F85F 
871 



F847 



& 
& 
& 
& 



FB43 

FB46 
FB49 

FB4B 

& FB4T) 
& FB4F 

& FB51 
& FB53 
& FB55 




64323 

64326 
64329 
64331 

64333 
64335 
64337 

64339 
64341 



•1213 

•1210 
-1207 

-1 205 

■1203 
-1 201 

■1199 

-11< 



SETWND 




A 



63583 -1953 NXTCOL A 
-1935 SCRN A 

-:alc a 



a,y 



A,Y 

A 

A 

A 
A 



A 
A 



— — — — 



DATA MANUPILATION FUNCTIONS 



There are a number of routines in the Monitor which may he called by 

\W«r% (trograms to perform often needed tasks. The routines described in 
t hi a nertion are miscellaneous routines which move data from place to 
|H art' oi- convert the form of information provided to the routines. 
No!.- Mint some of these routines are in both the Old Monitor and the 




ROUTINES 

Memory to Memory Move 

Thin rout In*- Is used by the Monitor ' t M" command. As the Command 
I n f i' i|M i'l i'i scans the keyboard input, fields Al, A2, and A4 are 
Imiitfil. When the Command Interpreter encounters the "M" it calls label 
WiVl;, nn liullrrw rd In the table. The contents of memory fron locations 
t A I ) i lmi (A/!) rife moved to memory beginning at location (A4). See t 
■um.pl |>ru>' t r:nn In the section "Secondary Display Area Ways and Means" 
n.r mm.' oi MtH'K from BASIC , with the assistance of the Monitor GO 
Tunf lue lor setting registers on the way in. 



Jump to Address with Registers 




The routine in the Monitor which responds to the "G" command uses some 
Monitor routines from BASIC or APPLESOFT in that the registers are 
loaded from the save area and then control is transferred to the 
location specified in PCL,H. Thus, a BASIC program can set up the 
destination address and register contents, and then CALL -468 to have 
the requested routine entered- This is used in sample programs in this 

m<**~»%*M*i rw™i ay Areas 1 '. 



Increment Address Fields 



The Monitor Move routine described above is a sample caller of the 
NXTA4 and NXTAl routines. When NXTA4 is called, it increments the two 
byte field A4L,H and then falls into label NXTAl. The routine at NXTAl 
increments the two byte field at A1L,H, and then compares that field 
to the two byte field A2L,H before returning to the calling program. 
On return to the calling program, the Carry status bit is clear if 
(A1L.K) is less than or equal to <A2L,H). Carry is set if fAlL.H) is 




The SAVE routine is used by various other Monitor routines to store 
the 6592 registers in page zero locations $43-$49. This routine may 
be called by user program under certain conditions - namely, that 
neither the Monitor nor any other program will be calling SAVE at the 
same time. In the Old Monitor SAVE and RESTORE are used in support of 
Monitor commands S and T, single step and instruction trace. In both 

Monitors, the SAVE routine is called on a BRK interrupt at entry point 
SAV1 as the A-reg is stored at $45 on entry into IRQ interrupt 
processing. 

Restore 6502 Registers 

The routine at label RESTORE is the inverse of the SAVK routine, 
except that the S-reg is not loaded, tn the Old Monitor, RESTORE is 
utilized by instruction step and trace routines before controlled 

;ers 





Multiply Routine 

Note in the following that the data fields for multiply and divide are 
fn the same format as other multiple byte numbers in the Apple: lowest 
memory address is least significant byte. 

Set Multiplier in 

Set Multiplicand in 
Should be zero - see 



$55,54 (MSB,LSB) 




t 



sign conventions or 



r FB63 (-1184 or -1181) 
dements. 



or MUL) de 



ng on 



The result, in order of most significant to least, is in $53, $52, 
$ r »l, $50. this result la positive. If one of the two input factors 




NOTE: The table of values above indicates that $53,52 should be set 
to zero before calling multiply. If this is not done, then the initial 
contents of this field will be added to the result. For example, if a 
I able has an origin of $8400 with 7 byte long entries, the address of 
i-ntry 8 can be determined bv Pn^rfnc the. m i1fUi» eftArtrt -i- 



Kx/mipl es : 



Called 
Rout ine 



Inputs 
$51 $50 $55 $54 



Outputs 
$53 $52 $51 : 



Mill 



00 01 
04 00 

FC 
FC 
7F 



FC 

n 



FF 



01 

00 01 
04 00 

FC 00 



00 

FC 

00 
00 

12 74 



w 

01 

08 
08 
F8 
7F 



01 



PS 
W 
02 
80 
56 



FF 



01 

00 



08 00 



F8 
00 



78 



00 



00 

00 
3F 



w 

00 

20 
20 

20 

FF 




n 00 

00 00 

00 20 

07 £0 

F4 20 

00 00 

01 00 
40 00 
06 26 



w 

01 

00 
00 

00 

n 



w 

00 



00 
01 



w 

n 



01 
02 
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Divide Four Byte Dividend by Two Byte Divisor 



This routine divides a four byte dividend by a two bit divisor, giving 

a two byte quotient and a two byte remainder- It is aveilable only In 

the Old Monitor. This routine accomplishes the division of the number 
in bytes $53,52,51,50 by the number in bytes $55,54, leaving the 
quotient in $51,50 and the remainder in $53,52 (most significant to 
least s--'^ — ^ 

If the contents of $53,52 is larger than the contents of $55,54, then 
the result will not fit in the quotient bytes - overflow is the 
result. The calling program must not let this happen. 

With regards to scaling, looking at the four byte dividend as an 
integer value and the divisor in $55,54 as an integer, the quotient 
and remainder fields are a 



Sign can be a problem if the DIVPM entry point is used. The sign 
of the dividend is the $80 bit of byte $51. If the intended divide 1b 
two bytes (with $53,52 cleared before divide) then signed fields 
division is supported, with the sign bit being the LSB of $2F. 
call Is to DIVPK, and if S2F contains $01, 
before using them. 



When using unsigned divide, entry point DIV, 
field by 16 bit field with 16 bit results. 



32 bit 



: 



: Remainder Sign 



— , 








DIV 

[$FB84] 
[64388] 
[-1248] 



00 40 00 00 




08 


00 


00 00 


00 


00 00 00 08 




00 


02 


00 00 


00 


00 01 00 00 


00 02 


80 


00 


00 00 


00 


00 00 00 03 


00 02 


00 


01 


i I 


it 


00 00 30 00 


02 00 


00 


18 


00 00 


00 


00 00 30 00 


20 00 


00 


01 


10 00 


00 


00 00 33 33 


00 22 


01 


81 


00 11 


00 


00 10 40 00 


04 00 


04 


10 


00 00 


00 


00 20 80 00 


08 00 


04 


10 


00 00 


01 


W 20 "BT 00 


W 00 


04 


0F 


06 00 


FT 


00 10~4T00 


04 00 


04 


20 


01 00 




00 80 00 00 


80 00 


01 


00 


00 00 




80 00 


08 00 


00 


113 


00 1| 





Establish a RESET Vector 




The Autostart Monitor supports an address vector for 
handling a RESET interrupt. It is called the Soft I 
is designed to allow ret__ r __-„ „ r „ 

vector is in page three. It contains the address to which control is 
to be transferred after the screen, keyboard, and other basic Apple 

hardware items have been set to their "initial" states. For example, 
the display hardware is set to display primary area text, and the 
Scroll Window full screen values are set. 



After such initialization Is performed, locations $03h'3 and $03f4 are 
tented against one another to determine whether the vector In $03F2- 

^3Fi is to be considered valid. If so, control is transferred to 
($01F2-03F3). Normally, this results in transfer of control to $K003 
to accomplish the result of entry to the Monitor of a control-C, re- 
■.-ntry into BASIC or APPLESOFT. During the bootstrap operation, DOS 
JnHtalls its own restart point in this vector. And, of course, you ma; 
wish to set some other value in this vector, such as that which will 
cause the tlonitor (with asterisk prompt) to be called, as was the 
normal case with the Old Monitor. To set a different value in that 
vector, POKE or store the desired value in $03F2-$03F3 and then CALL 
JSK to SETPWRC (SFB6F or -1169) to have the Monitor set S03F4 

ME 



Convert Hex Characters to Value for Use 

Programmer utility programs often m>ed input of address or data in hex 
rkmer than in decimal. The Monitor also uses input in hex, and 
therefore has a way of converting input hex characters to a value in a 
IJ<Md. The GETNl/M routine in the Monitor converts characters from the 
K.-vbnnrd input area ($0200-$02FF) to hex stored in A2L , H and 
r<»n<Wr loivitly fn A1L,H and A3L,U. 

The OKTNlfll routine converts characters in the $0200 area beginning at 

, ^. , 00+(Y-reft) and continuing until a character is found which is not a 

hex ■ 1 1 >* 1 1 (not 0-9 or A-F>. The result in A2L.H (and A1L.H and A3L.H 
li (.'101)10 Qf) is tho last four hex digits in the string converted if 

thi' Hiring Is more than four hex digits. If the string is fewer than 
luiir hex dibits the result field contains the value right adjusted 
wlih tpMim zeroes. A sample program is provided at the end of this 
.i.-cllon nhowlng use of CETNUM from 




Disassemble an Instruction 

TIm» Apple J I Monitor contains a disassembler by means of which one can 
dlnplny ii portion of a machine language program in mnemonics instead 
" ' l"" f ''"'X' M Inhel LIST ($FK5E) is the routine to which control 
panned when .'In- Monitor command ,T L" is used. This routine sets a 



counter to 20, and then calls the single Instruction disassembler 20 

times, with appropriate adjustment of the instruction pointer PCL,ll. 
This routine can be used as an example of how to use the locations in 
the address table with labels INSTDSP and PCAR.J, 

The routine at INSTDSP uses the INSDS1 routine to sot the zero page 
locations FORMAT and LENGTH appropriately for the instruction at 
(PCL,H). INSDS1 also prints to the screen the contents of PCL,H, the 
address of the instruction to be disassembled. On return from INSDSl, 
the INSTDSP routine controls the printing of the rest of the 
disassembly line* 

Note that PCL,H is not altered by disassembly of the instruction. 
Thus, it must be "maintained" by the program which calls INSTDSP. 
This is accomplished by calling the PCADJ routine, which returns the 
new values to the calling program, to store into PCL and PCH in the 

A-reg and Y-reg, respectively, having computed the new value from PCL 
and PCH and LENGTH (set by INSDSl). 

ADDRESS TABLE 

Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



64352 -1184 MULPK A,X,Y 



64355 -1181 HUL A,X,Y 

64385 -1151 D1VPM A,X,Y 

64388 -1148 DIV A,X,Y 

64420 -1116 HD1 A,X,Y 




OLD MONITOR ONLY 
Multiply signed fields leaving 
sign in LSB of SIGN. 



FB60 



Multiply fields unsigned, 

(51,^ * (55,54) J m:- 



FB6 




Set absolute values for ACL,H and 
AUXL,H leaving resulting sign in 
LSB of SIGN (called by MUTPM and 



AUTOSTART MONITOR ONLY 

Set validity of RESET vector. FB6F 64367 -1169 SETPWRC A 



BOTH OLD AND AUTOSTART MONITORS 

Monitor Command Processor GO entry. FER6 65206 -330 GO 



Set PCL,H from A1L,H if entered. & 

Call RESTORE, set all regs but S.& FFB Q 65209 -327 
Jump via PCL,H. 
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Hex +Dec 
Addr Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



Move Jiytes in memory to (A4L, 
from (A1L,H) thru (A2L,H) . 
Note: Y-reg must be zero on entry 




— 



Increment pointer A4L,H. 
Increment pointer A1L,K with 
M mm if resulting (A1L,1 

(A2L, ,: ' 



& FCB4 64692 -844 NXTA4 A 



Snve reps A,X,Y,P,S at 

$4 5-$49. 

K.'store 6502 rej>s A,X,Y,P from 
$4 5- $48. 



. ■ 



FK4A 65334 -182 SAVE 



A,X 



FF3F 65343 -\9'A RESTORE A,X,Y,P 



Convert hex characters fronr 




DlMJiasemble one 
<M»play Lhru 




FFA7 65447 -89 



CETNUM A,X,Y 



new arcer 
or trace or step - return results 
In A, Y regs Cor (PCL,!!), 



■ 



APPLESOFT SAMPLE DATA MANIPULATION 




141 



m 
aw 

KM 
\> W 

wit 

'in 

\M 
\ut 

\ 10 



REM 
REM 
REM 

rem 
vmo 1000: 

REM 

Wm 58,167: 
KJKK 



St$ - AD$ + " ,T : REM 
FOK | - 1 TO LEN (SI$) 
CCS - HI1>$ (815,1,1) 

<;<:% - asc (cc$) + 128 
roKK SI 2 + i.Cc? 

NKXT 

I'OKK 71,1: REM 
mm 49,0: REM 
CAM, - 327: REM 
MT - I'KKK (62) + 256 * 
IK ST > 1276/ THEN ST = 



DATA MANIPULATION FUNCTIONS 

SAMPLE PROGRAM 
MEMORY DUMP 

OF HEX AREA INDICATED. 
REM BYPASS 

CALL GETNUM ROUTINE 

REH PCL=$A7 
PCH=$FF 

BUILD STRING TO STO 




REM 
REM 

REM 



STORK 




*40 KKTIIKN 



SET YREG TO START AT LOCATION 513 
CLEAR MODE BYTE 
GO PROCESSOR 

PEEK (63): REM ST=START ADDRESS ($A2) 

REM TWO'S COMPLEMENT 



* 





1010 

1020 
1030 
1040 

1050 
1080 

1090 

1100 

1110 

1120 
1130 




REM DISPLAY HEX CONTENTS 
■ ST / 256 REM CET HI ADDRESS BYTE 
= <zt - qw7 * 256: 

+ 




POKE 58,163 
POKE 59,253 
f^AT.T. - 327 



■,SL%:POKE 6 
SL% - < INT (SL% / 8 
IF RM% THEN CALL -622 
POKE 71,0: REM SET M Y" REG TO ZERO 

REM PCL = $A3 
REM PCH = $FD 
REM CLEAR "Y" REG & $FDa3C 
E 36,29: PRINT "1 "; : REM SEPARATES HEX FROM AS 

REM DISPLAY ASCII CHARACTER CONTENTS 
= ST + 7 - RM% REM SEPARATES HEX FROM ASCII 
I = ST TO SE REM PRINT ASCII CONTENTS 
CX = PEEK (I): IF CX < 128 THEN CX = CX + 128 



CX$ = CHR$ 
PRINT CX$; 



■it 



■ 



= 



RETURN 

REM PROGRAM START 

PRINT "HEX DISPLAY" 

INPUT "ENTER ADDRESS ";AD$ 
IF AD$ = "END" THEN END 
IF LEN (ADS) = 



GOSUB 200: 
FOR J = 1 

GOSUB 600 
ST = ST + 8 

NEXT 

PRINT 
GOTO 1020 




HUE WITH 



- KM /.-> 



MONITOR COMMAND PROCESSOR 



The Monitor Command Processor is that part of the Monitor which 
responds to commands entered with the "*" prompt character. These 
commands include data movement from one location to another, c 
tape reading and writing, instruction disassembly, and others 
described in the Reference Manual. The Reference Manual contains 

complete description of use * " - J " — ~* * 



a 



manual describes calling some 
instead of from the keyboar 
return to the user program. 




ENTERING THE MONITOR COMMAND PROCESSOR 

The Monitor Command Processor is that part of the Monitor wh: 
keyboard input with the asterisk prompt character and performs 
requested service. "Entering" the Command Processor implies turn: 
over control of the machine to the Monitor Mode. When the 
pressed with the Old Monitor in the Apple the computer is placed In 
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L - 151} 




Monitor Mode. When the RESET key is pressed with the Autostart Monitor 

in the machine, the computer generally goes into BASIC or APPLESOFT. 
With the Autostart Monitor the only way to get into Monito 

entry points (g 



- 

CALL one 

In this mode, data may be mox 
command. 

transfer commands. Or any of the other Monitor commands may be used. 
However, having entered Monitor Mode, the Monitor Comnand Processor is 

reading the commands from the keyboard and then acting upon them. 

There are a number of entry points indicated in the address table for 

"entering" the Monitor Command Processor. Please note that once the 

Monitor is jumped to at the specified point, all of the initializati 
described after that entry point is also performed. 

I he at the end of each function description. 




is 




CALLING THE MONITOR COMMAND PROCESSOR 

"Calling" the Monitor Command Processor implies that return will take 
place to the calling program. However, the driver part of the Monitor 
Command Processor is not designed to operate in that fashion, so a 
nhort machine language program is required to allow exit back to the 

railing program. A sample program is provided at the end of this 
hoc t ton indicating the required setup. In the sample, the 
machine language routine is placed in page two (at $02FC) but it ma; 
In* placed anywhere desired. With this program, tlonitor calls from 
BASIC or APPLESOFT are both supported. 

A program which CALLs the Command Processor must first store the three 

hyli* exit routine somewhere. Then the program can POKE a string of 
Monitor commands into the input area, beginning at address $0200, the 

Inst command of each such string being a Monitor GO command to 

'rmiufcr control to the exit routine. In the sample, the last Monitor 
l oiiuriJinrl In the string is "02FCG". The function of the exit routine is 

lo pull one return address level (two bytes) off of the stack, and 

i h.-n do an UTS to return to the BASIC, APPLESOFT, or machine languag. 
en I I I in* program. 



ADDRESS TABLE 

1'imc! Ion 



Hex +Dec -Dec Monitor Registers 
Acdr Addr Addr Label Destroved 



Monitor Command Processor, "blank" 
mf ry point used for CR. 



FE00 65024 -512 BLl 



A,X,Y 



Hon I for Command Processor, "hi 

command entry point. 
Mori I lor Command Processor, Store 

rout I nt 1 . 
Monitor Command Processor, set 

M(H)K lor colon, pericd, 

ml MUM. 



L 



FE0B 65035 -501 STOR 



FE18 65048 -488 SETMODE A,Y 



Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Store appropriate value to I 

entered from BLANK also. 
Monitor Command Processor routine 

for less than (<) command. 

Monitor Command Processor MOVE 

routine. (A1L,H) thru (A2L.H) is 

whatever. 



65053 




,A4L,H) thru whatever 



«-. ( M!ip. ( I"!-,! tO 

irences printed thru COUT 
land Processor LIST 
(disassembler) routine: list 20 

instructions thru COUT. 
Set INVFLC to $3F - inverse video. 
Set INVF1.G to $FF = normal video. 
Set INVFLG from Y-reg. 
Set port (keyboard) for input. 

Set port (A) for input. 

Set port (screen) for output. 
Set port (A) for output. 

Set port (A2L) for output. 

Monitor Command Processor GO entry. 
Set PCL,H from A1L.H jf entered. & 
Call RESTORE, set all regs but S.& 
Jump via PCL.H. 

Monitor Command Processor Display 

Register contents . 
Monitor Command Processor Carriage 
Return entry. 

First, simulate entry of blank. 
Then POP 2 from stack and goto 
Monitor Command Processor at 
Restore registers from $4 5-49: 

Load STATUS and push to s 

Load A from ACC. 

Load X from XREG. 

Load Y from YREG. 

Load P from stack (PLP) and RTS 
Save 65^2 regs at $45-49. 

Save A-reg at ACC $4 5. 

Save X-reg at XREG $46. 

Save Y-reg at YREG $47. 

Save P-reg at STATUS $48. 

Save S-reg at SPNT $49. 



FE20 


65056 


-480 


LT 


A,X 


FE2G 


65068 


-468 


MOVE 


A (Y-0) 


FE36 


65078 


-458 


VFY 


A <Y=0) 


■ 

FF.5E 


65118 


-418 


■ 

LIST 


A f X,Y 


FE80 


65152 


-384 


SET IN V 


Y 










Y 


FES6 


65158 


-378 


SETIFLG 


none 


FE89 


65161 


-375 


SRTKBD 


A.X.Y 


FE8B 


65163 


-373 


IN PORT 


A,X,Y 


FE8D 


65165 


-371 


■ & ■ I i T 1 

INPRT 


A,X,Y 


FE93 


65171 


-365 


SETVID 


A,X,Y 


FE95 


65173 


-363 


OUTPORT 


A,X,Y 


FE97 


65175 


-361 


OUTPRT 


A,X,Y 


FEB 6 


65206 


-330 


GO 


A,X,Y,P 


FEB 9 


65209 


-327 






FEBC 


65212 


-324 






FEBF 


65215 


-321 


REGZ 




FEF6 


65270 


-266 


CRMON 





& 
& 



& 
& 

s 



FF42 
FF44 
FF46 
FF48 
FF4A 

FF4C 
FF4E 
FF50 



65346 
65348 
6535(3 
65352 
65354 

65356 
65358 



•190 

•188 
•186 
•1 84 
-182 



Clear 6502 decimal mode (set hex). 




RESTR1 



SAVE 



SAV1 



Monitor entry on 
or Power on. 

Call SETNORM - white on black. 
Call INIT - Text + full scroll. 
Call SETVID - screen as output. 

C- 

Clear 6502 
1 bell, 

>mmand Processor Entry 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 

— — 



:all SETKBD - keyboard = input, 
ear 6502 decimal mode ^pf fc*»v^ 



& 



FF5C 
FF5F 



Sot 



as prompt character. 



Set (A) as prompt character. 
Call GETLNZ to read command line. 
Clear MODE before scanning line. 

Pick up one command: 
Ca] 1 CF.TNUM to scan input line, 

Having hex digits in A2L,H, and 
returning with non-hex in A- 
Save Y at YSAV - current place in 
command line. 



& 
& 
& 
& 




next command in the line, if any. 

Monitor Command Processor command 
p.irHing routine; save hex digits 
in A2L f H, return with command 
(llrst non-hex) In A-reg, Y-reg 
a<*i for next character. 

Dill routine indicated by conmand 
character: 
Push address $FExx onto stack. 

Pass (MODE) to called routine in 
A-reg. 
Clear .MODE before call. 
C«U selected routine by RTS. 
Clear MODE byte between commands. 



FF6B 
FF6D 
FF70 

FF73 



FFA7 



65387 
65389 
65392 




65372 -164 
65375 




-149 
-147 
-1 44 



-I - 



•1 



FFC7 65479 -57 



HON 



- 



ZMODE 



01, 1) MONITOR ONLY 

Exoi'iite instruction at (PCL,H), 
wl t h display of instruction and 
re mil t reft I stars . 

M.Milior Command Processor TRACE 
I tint met Ions routine. 

Monitor STEP one instruction. 



All. ,11 60,61 $3C,3D 

A2M< 62,63 $3E,3F 

Ail.JI 6A.65 $40,41 

A4...M 66,67 $ 42,43 



FA43 64067 -1469 STEP 



FEC2 65218 -318 TRACE 



FEC4 65220 -316 



— * 




71 








I REM MONITOR COMMAND PROCESSOR SAMPLE PROGRAM 
10 AA$ = "2FC:68 68 60 N 2FCG REM SET UP RETURN ROUTINE 

II GOSUB \999- REM MOVE COMMAND TO KEYBOARD INPUT AREA 



[ 



1< 
110 



13| 

140 
141 

150 

1999 

1005 
1010 
1020 

1050 
1070 
1080 





REM RETURN IS SET. NOW CALL 

REM SOME MONITOR 
100 . IFF ?vrr. H 




GOSUB 1000: REM DO DI< 

PRINT : PRINT ; 
PRINT "THATS ALL* 11 
END 

B = 511: REM FOR LOOP IS 1 TO LIM, SO B=EYTE BEFORE $200 

LIM « LEN (AA$) 
FOR I - 1 TO LIM 

P$ = MII)$ (AA$,I,1) 

P - ASC (P$) + 
POKE B 4- I,P 
NEXT 



SPEAKER USE THROUGH THE MONITOR 



There are many ways to use the speaker in the Apple II* One of these 

ways Is to signal program events. The Monitor contains a routine which 

supports this use by toggling the speaker at 1 khz for .1 second. This 

is the "beep" heard when the RESET key is pressed or at completion of a 
tape record read or write. 



The Apple II does not contain the only speaker in town. — , 
printers which attach to the Apple II make a sound of some type when 

BELL code. On the Apple II keyboard this Is the 

tracter code is $87 or decimal 135. "Printing" this 
will cause the Apple to beep, and win cause a 




character through COUT will cause the Ap 
printer "boll" to sound if there is one. 




tor a user program to call the routine in the 
responds to output of $87 by sounding the beep. 

If you intend to sound the bell in the Apple regardless of 

output device in use, then directly call the routine in the 

Monitor which produces the sound; CALL -1059 (or CALL 644 77), 
or JSR FBDD expecting destruction of the A- reg and Y-reg. 



entry point in the Monitor which places a $87 in the' A- reg and 
"prints" it through COUT : CAT.T.-l 98 Cor CAT.T. MM 



■ 



TTCA>$87 wait :01~sec 




Hound the "bell". Else, RTS. 

Watt .01 seconds, then sound bell- FBDD 
Load Y = 192 for .1 sec of bell. & FBE2 
Toggle speaker at 1 KHZ for number FBE4 

of cycles in Y-reg. 
Print thru COUT "ERR" and bell code.FF2D 

[Tint bell code ($87) thru COUT. FF3A 




=IW3 — ran 



64477 -1059 

64482 -1054 

64484 -1952 

65325 -211 

65338 -198 





A,Y 




A,Y 


HELL2 


A,Y 


PRERR 


A 


BELL 


A 



C ASSETTE TAPE INPUT AND OUTPUT 

There are two primary entry points in the Monitor with regard to 

rending and writing tape. They are READ and WRITE. The requirements for 
(•filling these are described below. There are a number of other routine 
entry points which are used by the Monitor on hit and byte basis. These 

nrr described below to the extent of location in the Monitor and 

I nd ( rat I on of which Apple II programs call them, but the precise 
timings of instructions between consecutive calls is beyond the scope 

nl 1 1) I s manual . 



Am you will have found by now, some tape files are composed of one 

rem 



, „„d soma of two records. For example, LOADing an APPLESOFT or 
BASH: program results in two beeps, signaling the complc**--- - £ 
read* OJ two separate records from the tape. 



Del I nil Ions 



m 01 



A tape record is a single contiguous string of b 

Into or written from memory as a unit. A tape record is a 
pl.ys i cnl entity . 

A tile on tape is a series or sequence of one or more records 
roittalntng data in a logical organization. A file is a 1- ' 



An AIMM.KS«PT or BASIC program file consists of two records. For BASK 
M.e Urn! of these records is two bytes long, and contains the length 

txt Hi.. Hernnd record. When the Monitor has satisfied RA 
Hie llnst record, BASIC uses the record length indicated : 

l " 'let 4-niiiiie the start attd end points in memory into which the limm 

will read 1 he second record. Each call to READ or WRITE in the Moni 
urrompllMheM onlv one record input or output. 




AI'H.KSOI-T P 



rngraras are also SAVEd as two record sets or files. However, 
tli*' I I rul record is three bytes long: the first two bytes indicate the 
le.'ij-Jli, nod i he third byte is set to $55 to indicate a normal APPLESOFT 

II M dl Keren! tnted f 



Some other programs write a longer (but fixed length) first record 
containing length of the second record of the file, and other infor- 
mation about the file such as date of creation or name of the file- 



WRITE 



$FECD 65229 -307 



Before entry at this point, set the first byte address in AlL.H ($3C- 

3D) and the last byte address at A2I,,H ($3E-3F). The Monitor will write 
ten seconds of continuous tone (header) followed by the contents of 

memory as specified, followed by one byte of checksum (the result of 

Exclusive OR of all the data bytes written to the tape). 



READ 



$FEFD 65277 -259 

Before entry at this point, place the first byte address into A1L,H 
($3C-3D) and the last byte address into A2L.H ($3E-3K). The Monitor 
reads the data from the tape, 
locations, and maintaining a run 

page field called CHKSUM ($2E). When the last specified memory location 

the Monitor reads one more byte and 

SUM* If equal, the Monitor sounds a 
ogram. If not equal, the Monitor 
*Lng the beep and ret 




contents of 
s to the 



If you want to have the calling program determine whether the tape was 

read successfully or not, then some special actions must be taken* One 

method is to compare the contents of CH ($24) before the tape read with 
the contents after. If they are equal, ERR was not printed to the 

screen. If the cursor horizontal position (CH) has changed across the 
call to READ, then ERR must have been written to the screen. Tf this 
condition is encountered, the program can then ask the operator to 

position the tape and signal the program for another attempt at reading 
the record. Caution: If CSWL.H points to a printer card or ' 

routine which does not output to the screen, CH will 

e output of "ERR". 



CASSETTE INPUT/OUTPUT INTERNAL ROUTINES 

The following entry points/routines functions are described , but not 
documented in sufficient detail for call by user program. For some of 
them, timing is critical and the documentation for using them would 
depend on how they were to be used. 



HEADR 



Tlifn routine writes the synchronization monotone which is the first 
part of every tape record. When the WRITE routine calls HEADR, it 
a $40 into the A-reg causing a 10 second header to be written. The REA 
routine also calls HEADR to delay fro* first detection of data coming 
Ln from the tape to the first point at which reading for <$/[ detection 

— '"th a $16 before calling HEADR so the 

;t to about 3.5 seconds. This routine 

■ 

PLESOFT, but it Is used by rhe Programmer's 



begins. READ loads 
delay for hardwar 



Is not called by 3ASI 
Aid if\ Tape Verify ro 



or 



t 




$ KCFA 64762 -774 

This routine causes looping with decrementing of the Y-reg <intil the 
hardware has indicated two transitions of the tape input register. The 

routine RDBIT is called twice for this purpose. Contents of the Y— reg 
on return compared with contents on entry indicate the length of tine 
II Look for the transitions. 



Th I h routine is called from within the Monitor by the READ routine, to 

drlav entering data transfer aiode until tape input is available. READ 
on 1 Is ME ADR for the 3,5 second delay on return from its call to RD2BIT. 
This routine is also called from APPLESOFT and from the Tape Ve- 



-771 



Thl.n routine loops with decrementing of the Y-reg while testing the 
tape Input register for transition from zero to one or one to zero, 
value of zero or one is then determined from the residual count in 
Y-ri'K- This routine is called from within the Monitor routines 




$FCKC (>4 74 H -788 



Thin rout I n<- calls R?>2BIT as required in order to assemble a byte of 

I n I oniuil 1 on from the tape. It then returns to caller with the byte in 
Ihr A-rt'g. Tn addition to being called from the Monitor READ routine, 

II Ih nUo o.i tied by Shape Table Load in Programmer's Aid Si-:* 
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When called to write a byte to the tape, this routine uses WRBIT to 
write ten bits to the tape. The only caller is WRITE in the Monitor. 



PADDLES, BUTTONS & ANNUNCIATOR I/O 

The Apple II has a Game I/O connector with hardware support for four 

digital outputs, three digital inputs, and four analog inputs (called 

paddles). The Monitor reads the paddles by writing a strobe to start 
the paddle timer and then reading the selected paddie timer and 

incrementing the Y-reg until chat timer comes true. The result of the 

read is in the Y-reg. Monitor support for digital outputs or digit 

inputs is not required. Access to the digital I/O ports is gained by 

PEEKing or POKEing the appropriate address, or by LDx or ST X if 

machine language is used. The Autostart Monitor does initialize the 

digital output ports (annunciators) on any RESET key interrupt. AN0 

and AN1 are initialized to the clear (TTL LO) condition by reference 

to addresses $C053 and $C05A. AN 2 and AN 3 are initialized to the set 

(TTL HI) condition by reference to addresses SC05D and SC05F. 



To use the Monitor support to read the setting of a paddle, JSR to 



.IF. 



with paddle number (0-3) in X-reg, and on return the "value" of the 
paddle will be found In the Y-reg. The A-reg is destroyed in the 



process- (APPLESOFT and BASIC Support ] 
and looking at Y is not required there-', 



■ 



Direct reading of the paddles may be accomplished by accessing the 
paddle trigger to start all paddle timers and then reading the 
appropriate paddle input address repeatedly while counting until the 

value read from the paddle address no longer has the $80 bit set. 

CAUTION: After reading a paddle, let some time go by before reading 

another paddle or incorrect results may be a problem. When the paddle 
trigger is strobed, all the timers start- If the first paddle you 

read has n low value, on going back quickly to read another paddle 
the transition you see may be from the first paddle trigger instead 
of the second. See the sample program in the section "t 

Control-Y with Parameters". Mother solution is to do a read of a 



GAME I/O HARDWARE ADDRESS TABLE 



Hex +Dec -Dec 
Adrfr Addr Addr 




Paddle $ switch 

Paddle 1 switch 
Paddle 2 switch 



Clear 

Set 

Clear 

Set 
Clear 

Set 

Clear 

Set 



Annunciator 
Annunciator 
Annunciator 

Annunciator 
Annunciator 



Annunciator 
Annunciator 



output 

output 

1 output 

1 output 

2 output 

3 output. 
3 output . 




C061 

C062 
C063 

C058 
C059 
C05A 

C05B 
C05C 




49252 
492 53 



-16284 




49249 

49250 
49251 

49240 
49241 
49242 

49243 
49244 

49245 
49246 



-16287 

-16286 
-16285 

-1 6296 

-16295 
-16294 

-16293 
-1 6292 
-16291 
-16290 




Negative 

indicates 
button pushed 

POKE /Store 
zero 




ess • 



WAIT ROUTINE 



The WAIT routine consists of a loop within a loop, constructed in 
such a manner that the length of time spent in the loop varies 
geometrically with the entry A— res». A call to this routine will * 
a loop for a predictable length of time, such as is used by the 
Monitor with regards to using the speaker as a bell. It may be 

usable, for example, in writing data to a lower speed <j 
printer or a typewriter. 





Anaylsis of the code indicates that the time between the cal 




An alternative formula is 

TIME IN HICROSFXONDS = (2.5 * (A"2) + U 
where A = contents of accumulator 
= 13 machine c 



* A + m * MS 



WAIT ROUTINE DELAY TIMES 



A-reg Time in 
(Dec*) seconds 



A-re£ Time in 



(Dec) 



se 



conds 



A-reg Time in 
(Dec.) seconds 



1 



6 
7 
3 
9 

17 

18 

19 

25 
26 

31 



42 



.000029667 
.00005115 

>8 




.0W23529 

.000287463 

.000344751 

.000987195 
.00)090518 

1198956 



1956999 
2101242 



.002899182 




49 
50 



55 
56 
57 
58 



73 
74 

75 

85 
86 



97 

105 
106 



.006830571 137 
.007097574 138 




.014650383 

.015040146 
.015435024 

.019665129 
.020116272 

.024909027 
.025416435 

.029659839 
.030213282 



.03976401 




184 
1 



195 
196 

204 
205 

218 
219 

239 
240 



.049907055 
.050624178 





.099' 
.100 



.109263561 
.110323389 

•124566618 
.125698056 

.149400966 
.150639819 



USE OF CONTROL-Y WITH PARAMETERS 



In the AFPLESOFT manual there is a caution that if one paddle is 
another should not be read toe quickly. Following is a machine 




Initiate this program by entering the Monitor command xxxxY, where 
xxxk is a number representing the amount of delay to use between 
reading paddle and reading paddle 1, and Y represents control-Y. 

The Monitor command M control-Y" causes a JKP to location $03F8 at 
which location wp nlace a JMP to Hip hAoinn^o r»f Hi* nrnoram 



As the Monitor scans the input command line, the value of the hex 
digits is placed in page zero locations AIL JI M$mm for nnr 




PADDLE INTERFERENCE— SAMPLE PROGRAM 




Wm lda $#c0 

2002 STA S4 
2004 LDA 



200C 

2m 

2010 
2012 
2014 

2016 
2019 

201B 
201D 
201F 
2021 



202A 
202C 
202F 

2031 
2034 

2036 

2039 



r 7 



2(J4A 
204C 
204E 

2050 
2052 
2055 



STA 
LDA 
STA 
LDX 

JSR 
STY 

DEC 
BNE 

DEC 

BMI 



LDA 
JSR 
LDA 

JSR 
7.DA 
JSR 
JSR 





200 A STA $1 1 



$10 
?12 

Sll 
$13 

$w 

SFB1E 

$0 

$12 
$201B 
$13 
$20 IB 



2023 LDX $$1 

2025 JSR $FB1E 
2028 STY $1 



$FDDA 
$//A0 

$FDED 
$1 

$FDDA 
$F948 



BNF. 


$203C 


INC 


$4 


BNE 


$200C 


LDA 
STA 


$#0 
$4 


TNC 


$5 
$4 


BNE 


$204 A 


INC 


$5 


BNE 


$204A 


JSR 


$FC58 




$*C0 



Pick up low part of entered count from All, 



use . 



Lck up high part of entered count from A1H 
and store it for repeated use* 

Pick up low part of count: 
store it in counter for this pass, 

"i part. 



Set X for paddle read. 
Call paddle read. 

Store paddle result in location 0. 

Count down delay loop low byte: 
when zero, count down high byte. 

Stay in the loop until high goes minus 

I. 



Set X for paddle I re. 

Call paddle read. 

Store paddle 1 result in 

Pick up paddle value. 
Print it as a 
Pick ap a blank 
Print the blank. 
Pick up paddle 1 va. 
Print it as a hex value. 
Print three blanks. 



' for awhile to keep paddle 1 read 
from upsetting paddle results. 

Is it time to clear screen and restart? 
NE moans no, go back and sample again. 

Wait a while before clearing screen. 



i 1. 



Restore the per screen counter, 
and go one more big round. 
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REGISTERS FOR BASIC MONITOR CALLS 



Many of the entry points specified in this book require presetting of 

registers for proper operation. Following is a sample proj 

written for APPLESOFT, which uses Monitor calls for conversion fr 
decimal to hex. 



The theory behind the operation is that on a Monitor G command, the 

registers are loaded from the SAVE area before going to the location 

specified in PCL,H. Thus, by poking destination address into PCL,H 

and the required register contents into XREG, YREG, an entry point in 
the Monitor Go command processor can be used to pass the registers to 

a 





10 

113 

150 

$ 



350 

50(3 

550 
600 

65< 



REM CONVERT DECIMAL 
INPUT "ENTER NUMBER 
IF A=99999 THEN END 
CZ - A / 256 
POKE 71 ,C% 

B% - A / 256 
B - B% * 256 

* = A - B 

POKE 70,B% 
POKE 59,249 
POKE 58,64 

PRINT 
CALL 65; 
PRINT 




INPUT TO HEX OUTPUT 
";A Read the input. 

Provide a way to end the 
the high byte, 
for PRNTYX call, 
nainder from A/ 256. 




t 




t PCII to $F9. 
Set PCL to $40. 
Print a blank line. 
Entry point in GO pr< 
Print a blank line. 
Go around for another number. 



STEP AND TRACE PECULIARITIES 



The Step and Trace functions in the Old Monitor incorrectly display 

register contents under some circumstances. The STEP routine detects 

and gives special attention to JSR, RTS, JMP, JMP indirect, RTI, and 

BRK instructions. In each case, the register contents are displayed 
from the SAVE area at $45-49. However, there is no SAVE call after 

"execution" of these instructions, as there is for normally traced 

instructions, so the registers displayed are those present in the 
SAVE area before execution of this instruction. 

Therefore, on JSR and RTS, the displayed contents of the S-reg are 
incorrect. On the first instruction after a JSR or RTS, the S-reg 

displays correctly, unless that also is an RTS or JSR. 
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The Step and Trace routines are not incorrect in handling of a BRK 

instruction. That is, the address displayed for the BRK is correct 
instead of being off by two bytes, because the BRK is 

STEP routine instead of being executed by the 6502. 




Although step and trace can be very helpful for some program 

they cannot 

ling "print" output) or for 



debugging tasks, they cannot be used in tracing calls to the Monitor 

*i_^aL &.jfcjsc t.__,_..t % ^ e ^ ich use AlL>n 
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